talon-agent 3.8.1 → 3.9.0

package/src/frontend/terminal/commands.ts

@@ -15,7 +15,15 @@ import {
   resolveModel as coreResolveModel,
   getModels,
 } from "../../core/models/catalog.js";
-import { buildCacheDisplay } from "../shared/status-context.js";
+import {
+  buildCacheDisplay,
+  buildContextDisplay,
+} from "../shared/status-context.js";
+import {
+  formatDuration,
+  formatTokenCount,
+  formatUsd,
+} from "../shared/format.js";
 import {
   getChatSettings,
   setChatModel,
@@ -282,7 +290,7 @@ export function registerBuiltinCommands(): void {
       let displayCacheRead = u.totalCacheRead;
       let displayCacheWrite = u.totalCacheWrite;
       let backendModelLine = "";
-      let backendContextLine = "";
+      let contextWindow = u.contextWindow;
       ctx.renderer.writeln();
       const nameStr = info.sessionName ? `"${info.sessionName}"  ·  ` : "";
 
@@ -313,25 +321,55 @@ export function registerBuiltinCommands(): void {
         if (modelInfo) {
           backendModelLine = `  ${pc.bold(label)}  ${modelInfo.displayName}  ·  ${modelInfo.providerName}${modelInfo.free ? " · free" : ""}`;
           if (modelInfo.contextWindow) {
-            backendContextLine = cache
-              ? `  ${pc.dim(`context window ${modelInfo.contextWindow.toLocaleString()}  ·  cache ${cache.read.toLocaleString()} / ${cache.write.toLocaleString()}`)}`
-              : `  ${pc.dim(`context window ${modelInfo.contextWindow.toLocaleString()}`)}`;
+            contextWindow ||= modelInfo.contextWindow;
           }
         }
       }
 
+      const context = buildContextDisplay({
+        contextTokens: u.contextTokens,
+        lastPromptTokens: u.lastPromptTokens,
+        contextWindow,
+      });
+      const contextUsed = context.known
+        ? formatTokenCount(context.used)
+        : "unknown";
+      const contextMax = context.max
+        ? formatTokenCount(context.max)
+        : "unknown";
+      const avgResponseMs =
+        info.turns > 0 && u.totalResponseMs
+          ? Math.round(u.totalResponseMs / info.turns)
+          : 0;
+      const fastestResponseMs =
+        Number.isFinite(u.fastestResponseMs) && u.fastestResponseMs > 0
+          ? u.fastestResponseMs
+          : 0;
+
       ctx.renderer.writeln(
         `  ${pc.bold("Session")}  ${nameStr}turns ${info.turns}${cache ? `  ·  ${cache.hitPct}% cache` : ""}`,
       );
       ctx.renderer.writeln(
         `  ${pc.dim(`in ${displayInputTokens.toLocaleString()}  ·  out ${displayOutputTokens.toLocaleString()} tokens`)}`,
       );
+      ctx.renderer.writeln();
+      ctx.renderer.writeln(
+        `  ${pc.bold("Context")}  ${contextUsed} / ${contextMax} (${context.known ? `${context.pct}%` : "unknown"})${context.warn ? pc.yellow("  nearing limit") : ""}`,
+      );
+      ctx.renderer.writeln(
+        `  ${context.warn ? pc.yellow(context.bar) : pc.dim(context.bar)}`,
+      );
+      ctx.renderer.writeln(
+        `  ${pc.dim(`response last ${u.lastResponseMs ? formatDuration(u.lastResponseMs) : "—"}  ·  avg ${avgResponseMs ? formatDuration(avgResponseMs) : "—"}  ·  best ${fastestResponseMs ? formatDuration(fastestResponseMs) : "—"}`)}`,
+      );
+      if (u.estimatedCostUsd > 0) {
+        ctx.renderer.writeln(
+          `  ${pc.dim(`estimated session cost ${formatUsd(u.estimatedCostUsd)}`)}`,
+        );
+      }
       if (backendModelLine) {
         ctx.renderer.writeln();
         ctx.renderer.writeln(backendModelLine);
-        if (backendContextLine) {
-          ctx.renderer.writeln(backendContextLine);
-        }
       }
 
       const plugins = getLoadedPlugins();

package/src/frontend/terminal/input.ts

@@ -3,7 +3,7 @@
  *
  * Input is a list of parts: text segments and collapsed paste blocks.
  * You can type, paste, type more, paste again. Backspace removes from the end.
- * Enter submits everything. Ctrl+U clears all.
+ * Enter submits everything. Ctrl+U clears all. Up/Down walk prompt history.
  */
 
 import pc from "picocolors";
@@ -19,9 +19,10 @@ export type InputHandler = {
   resume(): void;
 };
 
-type TextPart = { type: "text"; content: string };
-type PastePart = { type: "paste"; content: string };
-type Part = TextPart | PastePart;
+export type InputPart =
+  { type: "text"; content: string } | { type: "paste"; content: string };
+type TextPart = Extract<InputPart, { type: "text" }>;
+type PastePart = Extract<InputPart, { type: "paste" }>;
 
 // ── Constants ────────────────────────────────────────────────────────────────
 
@@ -29,6 +30,79 @@ const PASTE_COLLAPSE_LINES = 3;
 const PASTE_COLLAPSE_CHARS = 150;
 const PASTE_START = "\x1b[200~";
 const PASTE_END = "\x1b[201~";
+const MAX_HISTORY_ITEMS = 100;
+
+function cloneParts(parts: readonly InputPart[]): InputPart[] {
+  return parts.map((part) => ({ ...part }));
+}
+
+function partsText(parts: readonly InputPart[]): string {
+  return parts
+    .map((part) => part.content)
+    .join("\n")
+    .trim();
+}
+
+/**
+ * In-process prompt history. Keeping this out of the persistent stores avoids
+ * creating a second plaintext transcript while still giving terminal users
+ * the expected Up/Down workflow.
+ */
+export class PromptHistory {
+  private readonly entries: InputPart[][] = [];
+  private cursor = 0;
+  private draft: InputPart[] | null = null;
+
+  constructor(private readonly maxItems = MAX_HISTORY_ITEMS) {}
+
+  add(parts: readonly InputPart[]): void {
+    const text = partsText(parts);
+    if (!text) return;
+
+    const latest = this.entries.at(-1);
+    if (!latest || partsText(latest) !== text) {
+      this.entries.push(cloneParts(parts));
+      if (this.entries.length > this.maxItems) this.entries.shift();
+    }
+    this.resetNavigation();
+  }
+
+  move(
+    direction: "previous" | "next",
+    current: readonly InputPart[],
+  ): InputPart[] | undefined {
+    if (this.entries.length === 0) return undefined;
+
+    if (direction === "previous") {
+      if (this.cursor === this.entries.length) {
+        this.draft = cloneParts(current);
+      }
+      if (this.cursor > 0) this.cursor--;
+      return cloneParts(this.entries[this.cursor]!);
+    }
+
+    if (this.cursor === this.entries.length) return undefined;
+    if (this.cursor < this.entries.length - 1) {
+      this.cursor++;
+      return cloneParts(this.entries[this.cursor]!);
+    }
+
+    this.cursor = this.entries.length;
+    return cloneParts(this.draft ?? [{ type: "text", content: "" }]);
+  }
+
+  /** Preserve an edited recalled prompt as the current draft. */
+  detach(parts: readonly InputPart[]): void {
+    if (this.cursor === this.entries.length) return;
+    this.cursor = this.entries.length;
+    this.draft = cloneParts(parts);
+  }
+
+  resetNavigation(): void {
+    this.cursor = this.entries.length;
+    this.draft = null;
+  }
+}
 
 // ── Factory ──────────────────────────────────────────────────────────────────
 
@@ -38,7 +112,8 @@ export function createInput(promptStr: string): InputHandler {
   let paused = false;
 
   // Input is an ordered list of parts
-  let parts: Part[] = [{ type: "text", content: "" }];
+  let parts: InputPart[] = [{ type: "text", content: "" }];
+  const history = new PromptHistory();
 
   // Bracketed paste accumulation
   let inPaste = false;
@@ -46,7 +121,7 @@ export function createInput(promptStr: string): InputHandler {
 
   // ── Helpers ──
 
-  function lastPart(): Part {
+  function lastPart(): InputPart {
     return parts[parts.length - 1]!;
   }
 
@@ -99,18 +174,17 @@ export function createInput(promptStr: string): InputHandler {
   }
 
   function getFullText(): string {
-    return parts
-      .map((p) => p.content)
-      .join("\n")
-      .trim();
+    return partsText(parts);
   }
 
   function clear(): void {
     parts = [{ type: "text", content: "" }];
+    history.resetNavigation();
   }
 
   function submit(): void {
     const text = getFullText();
+    if (!pendingResolve) history.add(parts);
     clear();
     process.stdout.write("\n");
 
@@ -135,6 +209,7 @@ export function createInput(promptStr: string): InputHandler {
       // Short paste — inline into current text part
       ensureTrailingText().content += text.replace(/\n/g, " ");
     }
+    history.detach(parts);
     redraw();
   }
 
@@ -160,6 +235,14 @@ export function createInput(promptStr: string): InputHandler {
       if (parts.length === 0) parts.push({ type: "text", content: "" });
       ensureTrailingText();
     }
+    history.detach(parts);
+    redraw();
+  }
+
+  function navigateHistory(direction: "previous" | "next"): void {
+    const recalled = history.move(direction, parts);
+    if (!recalled) return;
+    parts = recalled;
     redraw();
   }
 
@@ -236,9 +319,22 @@ export function createInput(promptStr: string): InputHandler {
 
       if (code === 0x1b) {
         if (i + 1 < chunk.length && chunk[i + 1] === "[") {
-          // ANSI escape sequence (arrows, etc.) — skip
+          // CSI escape sequence. Up/Down navigate history; the rest are
+          // ignored until cursor editing is implemented.
+          let end = i + 2;
+          while (end < chunk.length && chunk.charCodeAt(end) < 0x40) end++;
+          const final = chunk[end];
+          if (final === "A") navigateHistory("previous");
+          if (final === "B") navigateHistory("next");
+          i = end;
+        } else if (
+          i + 2 < chunk.length &&
+          chunk[i + 1] === "O" &&
+          (chunk[i + 2] === "A" || chunk[i + 2] === "B")
+        ) {
+          // Some terminals use application-cursor sequences (ESC O A/B).
+          navigateHistory(chunk[i + 2] === "A" ? "previous" : "next");
           i += 2;
-          while (i < chunk.length && chunk.charCodeAt(i) < 0x40) i++;
         } else if (pendingResolve) {
           // Bare Escape during waitForInput — cancel
           const resolve = pendingResolve;
@@ -253,6 +349,7 @@ export function createInput(promptStr: string): InputHandler {
       if (code === 0x09) {
         // Tab
         ensureTrailingText().content += "  ";
+        history.detach(parts);
         redraw();
         continue;
       }
@@ -261,6 +358,7 @@ export function createInput(promptStr: string): InputHandler {
 
       // Printable char
       ensureTrailingText().content += ch;
+      history.detach(parts);
       redraw();
     }
   });

package/src/frontend/terminal/renderer.ts

@@ -7,6 +7,7 @@
  */
 
 import pc from "picocolors";
+import { formatUsd } from "../shared/format.js";
 
 // ── Types ────────────────────────────────────────────────────────────────────
 
@@ -193,6 +194,7 @@ export function createRenderer(cols?: number, displayName = "Talon"): Renderer {
     if (typeof info.cacheHitPct === "number") {
       p.push(`${info.cacheHitPct}% cache`);
     }
+    if (info.costUsd > 0) p.push(formatUsd(info.costUsd));
     if (tools > 0) p.push(`${tools} tool${tools > 1 ? "s" : ""}`);
     writeln();
     writeln(`  ${pc.dim(p.join("  ·  "))}`);

package/src/{util → storage}/metrics.ts

@@ -8,7 +8,7 @@ import {
   todayUtc,
   type MetricsGrain,
   type MetricsLatencyAgg,
-} from "../storage/sessions.js";
+} from "./sessions.js";
 
 const legacyCounters = new Map<string, number>();
 

package/src/storage/scheduled-store.ts

@@ -40,9 +40,12 @@ export type ScheduledMessage = {
   /** Epoch ms when the message should be sent. */
   fireAt: number;
   createdAt: number;
-  /** Telegram: numeric message id to reply to. */
-  replyTo?: number;
-  /** Telegram: inline keyboard rows. */
+  /**
+   * Message id to reply to, in the owning frontend's native shape:
+   * numeric for Telegram, a snowflake string for Discord.
+   */
+  replyTo?: number | string;
+  /** Inline keyboard / button rows to replay at fire time. */
   rows?: ScheduledButtonRow[];
 };
 

package/src/util/config.ts

@@ -173,6 +173,14 @@ const nativeConfigSchema = z
      * (~/.talon/keys/bridge-token) — the network never gets an open bridge.
      */
     token: z.string().optional(),
+    /**
+     * Origins allowed to call the bridge from a BROWSER. Native clients
+     * (Electron main, Flutter, curl, talon-node) send no Origin header and
+     * never need an entry here. Anything listed gets a matching
+     * Access-Control-Allow-Origin; everything else is refused 403, so a
+     * random web page cannot drive the agent API on the user's machine.
+     */
+    allowedOrigins: z.array(z.string().min(1)).optional(),
     /**
      * Serve the bridge over TLS with a persistent self-signed certificate
      * (~/.talon/keys/); clients pin its SHA-256 fingerprint on first

package/src/util/log.ts

@@ -53,6 +53,7 @@ export type LogComponent =
   | "teams"
   | "discord"
   | "native"
+  | "mesh"
   | "config"
   | "access"
   | "github"

package/src/backend/codex/index.ts

@@ -1,33 +0,0 @@
-/**
- * Codex backend — barrel re-export.
- *
- * Wraps `@openai/codex-sdk` (which in turn spawns the `codex` CLI from
- * `@openai/codex`) and exposes a Backend-compatible API. The
- * implementation is split across focused modules:
- *
- *   - `constants.ts`   — system-prompt suffix, default model.
- *   - `state.ts`       — per-process state container.
- *   - `init.ts`        — backend init + lazy Codex-instance construction.
- *   - `mcp-config.ts`  — Talon MCP plugins → Codex `--config` TOML.
- *   - `handler.ts`     — main message handler (streaming, end_turn).
- *   - `factory.ts`     — registry registration.
- *
- * MCP integration: Codex configures MCP servers at thread-creation
- * time via TOML overrides. Talon rebuilds the `Codex` instance when
- * the active chat id changes so each chat sees its own MCP server
- * environment (frontend-tools + plugin servers).
- */
-
-export {
-  CODEX_SYSTEM_PROMPT_SUFFIX,
-  CODEX_DEFAULT_MODEL,
-  CODEX_DEFAULT_WORKING_DIRECTORY,
-} from "./constants.js";
-
-export { initCodexAgent, ensureCodex } from "./init.js";
-
-export { handleMessage, getActiveAbort } from "./handler/index.js";
-
-export { runOneShotAgent } from "./one-shot.js";
-
-export { buildCodexMcpServers, type CodexMcpServer } from "./mcp-config.js";

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

@@ -1,48 +0,0 @@
-/**
- * OpenAI Agents backend — barrel.
- *
- * Importing this module registers the backend with the registry via
- * `factory.ts`'s side-effect import. Most callers should NOT need to
- * reach in here — the bootstrap layer picks the active backend by id.
- */
-
-import "./factory.js";
-
-export {
-  initOpenAIAgentsAgent,
-  getOpenAIApiKey,
-  getOpenAIBaseUrl,
-  triggerDiscoveryRefresh,
-} from "./init.js";
-export {
-  awaitDiscovery,
-  startDiscovery,
-  refreshDiscovery,
-  hasDiscoveredCatalog,
-  fetchEndpointModels,
-  extractCapabilities,
-} from "./discovery.js";
-export { handleMessage, getActiveAbort } from "./handler/index.js";
-export { resetState, getState } from "./state.js";
-export {
-  resolveModel,
-  getModelInfo,
-  getSettingsPresentation,
-  getProviders,
-  getProviderModels,
-  formatModelError,
-  listModels,
-} from "./models.js";
-export {
-  OPENAI_AGENTS_SYSTEM_PROMPT_SUFFIX,
-  OPENAI_AGENTS_DEFAULT_MODEL,
-  OPENAI_AGENTS_MAX_TURNS,
-  OPENAI_AGENTS_AGENT_NAME,
-} from "./constants.js";
-export {
-  getOrCreateBundle,
-  releaseBundle,
-  releaseAllBundles,
-  getActiveBundleIds,
-} from "./mcp-pool.js";
-export type { OpenAIAgentsMcpBundle, BundleInputs } from "./mcp-pool.js";

package/src/cli/plugin-entries.ts

@@ -1,104 +0,0 @@
-/**
- * Pure helpers over the config `plugins` array for the `talon plugin`
- * command group. The CLI edits config.json as JSON — entries here are the
- * on-disk shape (`core/plugin/types.ts` PluginEntry), not loaded plugins.
- * No filesystem or process access — everything is testable data-in/data-out.
- */
-
-/** On-disk plugin entry — path-based module or standalone MCP server. */
-export type PluginEntryJson = {
-  path?: string;
-  config?: Record<string, unknown>;
-  name?: string;
-  command?: string;
-  args?: string[];
-  env?: Record<string, string>;
-  enabled?: boolean;
-};
-
-/**
- * Built-in plugins toggled by their own config sections (`github.enabled`,
- * …) rather than `plugins[]` entries — see core/plugin/builtins.ts.
- */
-export const BUILTIN_PLUGINS = [
-  "github",
-  "mempalace",
-  "mem0",
-  "playwright",
-] as const;
-
-export function isBuiltinPlugin(name: string): boolean {
-  return (BUILTIN_PLUGINS as readonly string[]).includes(name);
-}
-
-/** Split a config path on either separator — Windows configs carry `\`. */
-function pathSegments(path: string): string[] {
-  return path.split(/[\\/]+/).filter(Boolean);
-}
-
-/**
- * Display name for an entry: the MCP name, or for path entries the package
- * name — segments after the last `node_modules` (preserving `@scope/pkg`),
- * else the folder basename.
- */
-export function entryDisplayName(entry: PluginEntryJson): string {
-  if (entry.name) return entry.name;
-  if (!entry.path) return "(invalid entry)";
-  const segments = pathSegments(entry.path);
-  const nm = segments.lastIndexOf("node_modules");
-  if (nm >= 0 && nm < segments.length - 1) {
-    return segments.slice(nm + 1).join("/");
-  }
-  return segments[segments.length - 1] ?? entry.path;
-}
-
-/** Does `token` identify this entry? Display name, basename, or full path. */
-export function entryMatches(entry: PluginEntryJson, token: string): boolean {
-  if (entryDisplayName(entry) === token) return true;
-  if (!entry.path) return false;
-  const segments = pathSegments(entry.path);
-  return entry.path === token || segments[segments.length - 1] === token;
-}
-
-export function findEntryIndex(
-  entries: PluginEntryJson[],
-  token: string,
-): number {
-  return entries.findIndex((entry) => entryMatches(entry, token));
-}
-
-/**
- * Index of an entry with the same identity as `candidate` (same module
- * path or same MCP name) — the duplicate an install must replace.
- */
-export function findConflictIndex(
-  entries: PluginEntryJson[],
-  candidate: PluginEntryJson,
-): number {
-  return entries.findIndex((entry) =>
-    candidate.path !== undefined
-      ? entry.path === candidate.path
-      : entry.name !== undefined && entry.name === candidate.name,
-  );
-}
-
-/**
- * Copy of `entry` with the enabled state applied. Enabled is the default,
- * so enabling removes the key rather than writing `enabled: true`.
- */
-export function withEnabled(
-  entry: PluginEntryJson,
-  enabled: boolean,
-): PluginEntryJson {
-  const { enabled: _drop, ...rest } = entry;
-  return enabled ? rest : { ...rest, enabled: false };
-}
-
-/**
- * Package name of an npm spec, version stripped: `pkg@1.2` → `pkg`,
- * `@scope/pkg@^1` → `@scope/pkg`. A leading `@` is the scope, not a version.
- */
-export function npmSpecName(spec: string): string {
-  const at = spec.lastIndexOf("@");
-  return at > 0 ? spec.slice(0, at) : spec;
-}

package/src/core/agent-runtime/index.ts

@@ -1,62 +0,0 @@
-/**
- * Agent runtime — barrel for the primitives every backend, frontend,
- * and dispatcher consumer reads through. See `agent-runtime/README.md`
- * for the module map.
- *
- *   - `AgentEvent`     + helpers   (events.ts)
- *   - `ModelRef`       + helpers   (model-ref.ts)
- *   - `Backend` + capability interfaces + `composeBackend` (capabilities.ts)
- *   - Backend contract assertions                          (contract-tests.ts)
- */
-
-export {
-  type AgentEvent,
-  type AgentError,
-  type AgentErrorKind,
-  type AgentResult,
-  type UsageSnapshot,
-  addUsage,
-  AgentRunError,
-  classifiedToAgentError,
-  emptyUsage,
-  isAgentEventOf,
-  isAgentRunTerminator,
-  toolInputToRecord,
-} from "./events.js";
-
-export {
-  type BackendId,
-  type CacheSupport,
-  type ModelRef,
-  type ModelSource,
-  BACKEND_IDS,
-  isBackendId,
-  makeBareModelRef,
-  sameModelRef,
-} from "./model-ref.js";
-
-export {
-  type Backend,
-  type BackgroundRunner,
-  type ChatBackend,
-  type ChatRunParams,
-  type ModelCatalog,
-  type SessionBackend,
-  type SystemControl,
-  type ToolRefreshResult,
-  type ToolRuntime,
-  type UsageTelemetry,
-  composeBackend,
-} from "./capabilities.js";
-
-export {
-  assertBackendContract,
-  assertBackendIdentity,
-  assertBackgroundRunnerLifecycle,
-  assertChatBackendEmitsRunStarted,
-  assertChatBackendEmitsSingleUsage,
-  assertChatBackendTerminates,
-  assertCompletedUsageMatchesUsageEvent,
-  assertModelCatalogDefaultShape,
-  assertUsageTelemetryShape,
-} from "./contract-tests.js";

package/src/core/background/index.ts

@@ -1,21 +0,0 @@
-/**
- * Background agents — everything that runs without a user message.
- *
- *   - `heartbeat` — periodic autonomous agent pass ("anything need
- *     doing?"), prompted by prompts/heartbeat.md.
- *   - `dream`    — memory-consolidation agent (daily notes → memory,
- *     mempalace mining), prompted by prompts/dream.md.
- *   - `pulse`    — lightweight liveness/typing-indicator ticker.
- *   - `cron`     — persistent user-scheduled jobs (message / query).
- *   - `triggers` — user-authored watcher scripts that fire wake-ups.
- *
- * All of these drive the backend through the same `BackgroundRunner`
- * surface (core/agent-runtime/capabilities.ts) — they never talk to a
- * concrete backend directly.
- */
-
-export * from "./heartbeat/index.js";
-export * from "./dream.js";
-export * from "./pulse.js";
-export * from "./cron.js";
-export * from "./triggers/index.js";

package/src/core/engine/index.ts

@@ -1,20 +0,0 @@
-/**
- * Engine — the message-flow core.
- *
- *   - `dispatcher`         — per-chat serial, cross-chat parallel turn
- *     execution; the single entry point for "run this user message".
- *   - `gateway`            — loopback HTTP bridge the MCP tool
- *     subprocesses call back into.
- *   - `gateway-actions`    — the action handlers the bridge dispatches
- *     to (send/edit/react/cron/trigger/admin …).
- *   - `backend-controller` — backend lifecycle: init, hot-swap,
- *     cleanup, registry lookup.
- *
- * Everything here is frontend- and backend-agnostic: frontends feed
- * the dispatcher, backends are reached through the agent-runtime
- * capability slots.
- */
-
-export * from "./dispatcher.js";
-export * from "./gateway.js";
-export * from "./backend-controller/index.js";

package/src/core/models/index.ts

@@ -1,17 +0,0 @@
-/**
- * Model layer — everything about "which model is the chat using".
- *
- *   - `catalog`          — model-id resolution, defaults, and the
- *     curated cross-backend catalog.
- *   - `active-model`     — per-chat active-model resolution
- *     (chat-settings → config → backend default).
- *   - `reasoning-levels` — the reasoning-effort vocabulary shared by
- *     every backend (order, labels, normalisation).
- *
- * Presentation helpers (menus, status lines) live in `frontend/` —
- * this layer is pure domain.
- */
-
-export * from "./catalog.js";
-export * from "./active-model.js";
-export * from "./reasoning-levels.js";