talon-agent 3.32.0 → 3.33.0

package/src/backend/shared/index.ts

@@ -32,41 +32,26 @@
  *     (the spawn/env contract they share is `core/tools/mcp-env.ts`).
  */
 
-export {
-  normalizeForDedupe,
-  isDuplicateOfDelivered,
-  captureDeliveredText,
-} from "./delivered-text.js";
+export { captureDeliveredText } from "./delivered-text.js";
 
 export {
-  FLOW_VIOLATION_REMINDER,
   FLOW_VIOLATION_MAX_RETRIES,
   detectFlowViolation,
-  type FlowViolationInputs,
-  type FlowViolationResult,
 } from "./flow-violation.js";
 
-export { registerTurnInterrupt, interruptChatTurn } from "./turn-interrupt.js";
+export { registerTurnInterrupt } from "./turn-interrupt.js";
 
-export { formatUserPrompt, type PromptFormatInputs } from "./prompt-format.js";
+export { formatUserPrompt } from "./prompt-format.js";
 
 export {
   buildDeliveryContract,
   buildFlowViolationReminder,
   buildFirstTurnReminder,
-  deliveryToolsForFrontend,
-  registerFrontendDeliveryTools,
-  type DeliveryMode,
-  type DeliveryToolNames,
 } from "./delivery-contract.js";
 
 export { extractSessionName } from "../../util/session-name.js";
 
-export {
-  cacheHitPercent,
-  summarizeUsage,
-  type TokenUsageSnapshot,
-} from "./usage.js";
+export { summarizeUsage } from "./usage.js";
 
 // Only what is consumed THROUGH the barrel. Everything else in
 // cache-telemetry.ts is imported from the module directly, matching the
@@ -79,26 +64,15 @@ export {
   CACHE_LOOKBACK_BLOCKS,
 } from "./cache-telemetry.js";
 
-export {
-  prepareSystemPrompt,
-  appendBackendSuffix,
-  clearSystemPromptSnapshots,
-  type PrepareSystemPromptInputs,
-  type PreparedSystemPrompt,
-} from "./system-prompt.js";
+export { prepareSystemPrompt, appendBackendSuffix } from "./system-prompt.js";
 
-export {
-  classifyRetry,
-  type RetryDecision,
-  type ClassifyRetryInputs,
-} from "./model-retry.js";
+export { classifyRetry } from "./model-retry.js";
 
 export {
   createStreamState,
   appendText,
   closeCurrentSegment,
   markProgressDelivered,
-  undeliveredResponseText,
   recordToolUse,
   recordTokens,
   pushLiveUsage,
@@ -110,25 +84,15 @@ export {
   routeDelivery,
   buildDeliveryFailureReminder,
   TextBlockDeliveryError,
-  type DeliveryRoute,
-  type DeliveryDecision,
-  type RouteDeliveryInputs,
 } from "./delivery.js";
 
 export { sleep } from "./sleep.js";
 
-export { nonTerminalFrontends } from "./frontends.js";
-
 export {
   recordToolCall,
   recordTurnMetrics,
   recordFailedTurnAccounting,
   recordFlowViolation,
-  type TurnMetricInputs,
 } from "./metrics.js";
 
-export {
-  applyRetryDecision,
-  type ApplyRetryDecisionInputs,
-  type ApplyRetryDecisionResult,
-} from "./handle-retry.js";
+export { applyRetryDecision } from "./handle-retry.js";

package/src/cli/logs.ts

@@ -17,7 +17,7 @@ const LEVEL_LABELS: Record<number, string> = {
   60: pc.bgRed(pc.white("FTL")),
 };
 
-export function formatLogLine(line: string): string {
+function formatLogLine(line: string): string {
   try {
     const obj = JSON.parse(line);
     const level = LEVEL_LABELS[obj.level as number] ?? pc.dim("???");

package/src/cli/status.ts

@@ -9,7 +9,7 @@ import { findRunningInstance } from "../core/daemon/discovery.js";
 import { printBanner, loadConfig } from "./config.js";
 import { CONFIG_FILE } from "./context.js";
 
-export function formatUptime(seconds: number): string {
+function formatUptime(seconds: number): string {
   if (seconds < 60) return `${seconds}s`;
   if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
   return `${Math.floor(seconds / 3600)}h ${Math.floor((seconds % 3600) / 60)}m`;

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

@@ -58,7 +58,7 @@ export interface BackendInitContext {
 }
 
 /** Result returned by a backend factory's `init` step. */
-export interface BackendInstance {
+interface BackendInstance {
   /** The fully-wired `Backend` the dispatcher will route to. */
   backend: Backend;
   /**

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

@@ -188,7 +188,7 @@ export interface SessionBackend {
  * the live registry. Returns the diff so the dispatcher can log
  * what changed.
  */
-export interface ToolRefreshResult {
+interface ToolRefreshResult {
   added: string[];
   removed: string[];
   errors: Record<string, string>;

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

@@ -81,7 +81,7 @@ export interface AgentResult {
  * `core/errors.ts` already produces — keep the values stable so
  * downstream code can pattern-match deterministically.
  */
-export type AgentErrorKind =
+type AgentErrorKind =
   | "context_overflow"
   | "rate_limit"
   | "overload"

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

@@ -83,7 +83,7 @@ export function buildHeartbeatSystemPrompt(): string {
  * the heartbeat is a global agent, so it sees every chat's open goals (with
  * chat ids for routing updates back). Exported for tests.
  */
-export function renderGoalsBlock(): { text: string; count: number } {
+function renderGoalsBlock(): { text: string; count: number } {
   let text = "(no open goals)";
   let count = 0;
   try {

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

@@ -13,7 +13,6 @@
  * Re-exports the same public surface the old single-file module exposed.
  */
 
-export type { HeartbeatState } from "./state.js";
 export {
   initHeartbeat,
   startHeartbeatTimer,
@@ -22,4 +21,4 @@ export {
   forceHeartbeat,
   getHeartbeatStatus,
 } from "./scheduler.js";
-export { buildHeartbeatSystemPrompt, renderGoalsBlock } from "./agent.js";
+export { buildHeartbeatSystemPrompt } from "./agent.js";

package/src/core/background/isolated-agent.ts

@@ -19,7 +19,7 @@ import type { OneShotAgentParams, OneShotUsage } from "../types.js";
 import { logWarn, logError } from "../../util/log.js";
 
 /** Default bounded grace after an abort before giving up on the backend. */
-export const DEFAULT_ABORT_GRACE_MS = 30 * 1000;
+const DEFAULT_ABORT_GRACE_MS = 30 * 1000;
 
 export interface IsolatedRunOptions {
   readonly background: BackgroundRunner;

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

@@ -79,7 +79,7 @@ export async function shutdownTriggers(): Promise<void> {
   await new Promise((r) => setTimeout(r, 250));
 }
 
-export function killChild(id: string, child: ChildProcess): void {
+function killChild(id: string, child: ChildProcess): void {
   try {
     child.kill("SIGTERM");
   } catch {

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

@@ -19,7 +19,7 @@ import { commandForLanguage } from "./command.js";
 import { handleStdoutLine } from "./output.js";
 import { handleTimeout, finalizeExit } from "./exit.js";
 
-export { initTriggers, getRunningCount, type TriggerDeps } from "./state.js";
+export { initTriggers, getRunningCount } from "./state.js";
 export { commandForLanguage } from "./command.js";
 export { spawnTrigger } from "./spawn.js";
 export { cancelTrigger, shutdownTriggers } from "./exit.js";

package/src/core/bus/events.ts

@@ -32,7 +32,7 @@ export interface TaskSettledEvent {
 }
 
 /** A chat turn bound its warp and is about to run on the backend. */
-export interface TurnStartedEvent {
+interface TurnStartedEvent {
   readonly type: "turn.started";
   readonly chatId: string;
   readonly source: string;
@@ -41,7 +41,7 @@ export interface TurnStartedEvent {
 }
 
 /** A chat turn finished successfully (refusals and failures never emit this). */
-export interface TurnCompletedEvent {
+interface TurnCompletedEvent {
   readonly type: "turn.completed";
   readonly chatId: string;
   readonly source: string;

package/src/core/doctor.ts

@@ -17,7 +17,7 @@ import { execFileSync } from "node:child_process";
 import { NATIVE_MODULES } from "../native/registry.js";
 import { dirs } from "../util/paths.js";
 
-export type DoctorStatus = "ok" | "warn" | "fail" | "info";
+type DoctorStatus = "ok" | "warn" | "fail" | "info";
 
 export interface DoctorCheck {
   label: string;

package/src/core/engine/backend-controller/index.ts

@@ -28,7 +28,7 @@
  */
 
 export * from "./types.js";
-export { roleHolder, chatHolder } from "./holders.js";
+export { roleHolder } from "./holders.js";
 export {
   initBackendPool,
   hasBackendPool,
@@ -48,8 +48,6 @@ export {
   clearBackendChangeListenersForTest,
 } from "./pool.js";
 export {
-  rebindHolder,
-  releaseHolder,
   rebindRole,
   rebindChat,
   releaseChat,

package/src/core/engine/backend-controller/rebind.ts

@@ -36,7 +36,7 @@ import type { BackendHolder, BackendRole, RebindResult } from "./types.js";
  *
  * Use `rebindRole` / `rebindChat` for typed wrappers.
  */
-export async function rebindHolder(
+async function rebindHolder(
   holder: BackendHolder,
   newId: string,
   config: TalonConfig,
@@ -113,7 +113,7 @@ export async function rebindHolder(
  * No-op when the holder isn't bound — useful for "clear my override"
  * flows that don't want to care whether the override was ever set.
  */
-export async function releaseHolder(holder: BackendHolder): Promise<void> {
+async function releaseHolder(holder: BackendHolder): Promise<void> {
   const id = bindings.get(holder);
   if (!id) return;
   bindings.delete(holder);

package/src/core/engine/dispatcher.ts

@@ -11,12 +11,7 @@
 import type { ExecuteParams, ExecuteResult } from "../types.js";
 import { log } from "../../util/log.js";
 import { taskTable, type KillOutcome } from "../tasks/index.js";
-import {
-  initWeaver,
-  type Weaver,
-  type WeaverDeps,
-  type ThreadSnapshot,
-} from "../weaver/index.js";
+import { initWeaver, type Weaver, type WeaverDeps } from "../weaver/index.js";
 
 // ── Dependencies (injected at startup) ──────────────────────────────────────
 
@@ -49,15 +44,6 @@ export function getActiveCount(): number {
   return weaver?.getActiveCount() ?? 0;
 }
 
-/**
- * A live view of every Thread the Loom holds — model/backend warp, in-flight
- * count, and context state per chat. The hub's observability surface for
- * `/status`, drift detection, and remote frontends. Empty before init.
- */
-export function snapshot(): ThreadSnapshot[] {
-  return weaver?.snapshot() ?? [];
-}
-
 /**
  * Stop only this chat's active turn. A later message already waiting in the
  * per-chat FIFO is intentionally left alone and runs after the stop settles.

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

@@ -100,6 +100,3 @@ export async function handleChatFreeAction(
   if (!handler) return null;
   return handler(body, 0);
 }
-
-export { chatFreeActions };
-export type { SharedActionHandler, SharedActionHandlers } from "./types.js";

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

@@ -9,7 +9,7 @@
 import type { ActionResult } from "../../types.js";
 import type { Backend } from "../../agent-runtime/capabilities.js";
 
-export type SharedActionHandler = (
+type SharedActionHandler = (
   body: Record<string, unknown>,
   chatId: number,
   backend?: Backend | null,

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

@@ -58,5 +58,3 @@ export type FrontendCreate = (
 
 /** A fully-registered frontend: identity plus the factory. */
 export type FrontendFactory = FrontendDescriptor & { create: FrontendCreate };
-
-export type { FrontendDescriptor } from "./registry.js";

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

@@ -9,12 +9,7 @@
 
 import "./builtins.js";
 
-export type {
-  Frontend,
-  FrontendCreate,
-  FrontendDescriptor,
-  FrontendFactory,
-} from "./capabilities.js";
+export type { Frontend } from "./capabilities.js";
 export {
   getFrontendDescriptor,
   hasFrontend,

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

@@ -12,5 +12,4 @@ export {
   getFrontendDescriptor,
   resolveFrontendIdAmong,
   resolveOwnerFrontendId,
-  type FrontendDescriptor,
 } from "./registry.js";

package/src/core/mcp-hub/children.ts

@@ -82,11 +82,6 @@ function failureBackoffMs(count: number): number {
   );
 }
 
-/** Test seam: forget recorded spawn failures. */
-export function resetSpawnFailures(): void {
-  spawnFailures.clear();
-}
-
 /** Idle TTL for hub children; tunable for tests / tight deployments. */
 function idleTtlMs(): number {
   const raw = Number(process.env.TALON_MCP_HUB_IDLE_MS);

package/src/core/mesh/index.ts

@@ -7,21 +7,4 @@
  */
 
 export { MeshRegistry } from "./registry.js";
-export {
-  MeshService,
-  getMeshService,
-  setMeshService,
-  type MeshTransport,
-  type MeshServiceOptions,
-  type MeshToolResult,
-} from "./service.js";
-export {
-  sanitizeCapabilities,
-  toDeviceInfo,
-  toDeviceLocation,
-  type DeviceCommand,
-  type DeviceCommandResult,
-  type DeviceInfo,
-  type DeviceLocation,
-  type DevicePlatform,
-} from "./types.js";
+export { MeshService, getMeshService, setMeshService } from "./service.js";

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

@@ -307,25 +307,6 @@ export async function getActiveModelForChat(
   return model;
 }
 
-/**
- * Convenience: same as `resolveActiveModelForChat` but returns just
- * the `ModelRef` (or `null`). Use when the source tag isn't needed.
- */
-export async function getActiveModelRefForChat(
-  chatId: string,
-  backend: Backend | null,
-  backendId: string | null,
-  config: TalonConfig,
-): Promise<ModelRef | null> {
-  const { ref } = await resolveActiveModelForChat(
-    chatId,
-    backend,
-    backendId,
-    config,
-  );
-  return ref;
-}
-
 // ── ref enrichment ──────────────────────────────────────────────────────────
 
 /**

package/src/core/plugin/index.ts

@@ -20,7 +20,6 @@ export {
   getPlugin,
   getPluginCount,
   destroyPlugins,
-  registerPlugin,
   getPluginPromptAdditions,
 } from "./loader.js";
 export { loadBuiltinPlugins, reloadPlugins } from "./builtins.js";

package/src/core/plugin/registry.ts

@@ -11,7 +11,7 @@ import { pathToFileURL } from "node:url";
 import { logError, logWarn } from "../../util/log.js";
 import type { LoadedPlugin, PluginMcpEntry } from "./types.js";
 
-export class PluginRegistry {
+class PluginRegistry {
   private readonly plugins: LoadedPlugin[] = [];
   private readonly standaloneMcpServers: PluginMcpEntry[] = [];
 

package/src/core/prompt/templates.ts

@@ -117,8 +117,3 @@ export function loadSystemTemplate(
   }
   return liquid.renderSync(parsed, vars) as string;
 }
-
-/** Test seam: drop the parse cache (e.g. after writing fixture templates). */
-export function clearTemplateCache(): void {
-  parseCache.clear();
-}

package/src/core/scripting/lua-runner.ts

@@ -70,7 +70,7 @@ const FIRE_PREFIX = "TALON_FIRE:";
  * Throws on Lua errors (message shaped `<file>:<line>: <msg>` plus
  * traceback). Restores process.stdout.write before returning.
  */
-export async function runLuaScript(scriptPath: string): Promise<void> {
+async function runLuaScript(scriptPath: string): Promise<void> {
   const source = readFileSync(scriptPath, "utf-8");
 
   const originalWrite = process.stdout.write;

package/src/core/scripts/runner.ts

@@ -19,7 +19,7 @@ import { commandForLanguage } from "../background/triggers/index.js";
 import type { Script } from "../../storage/script-store.js";
 
 export const DEFAULT_SCRIPT_TIMEOUT_SECONDS = 60;
-export const MAX_SCRIPT_TIMEOUT_SECONDS = 300;
+const MAX_SCRIPT_TIMEOUT_SECONDS = 300;
 
 /** Cap on captured stdout/stderr — keeps tool results context-friendly. */
 const OUTPUT_CAP_CHARS = 16_000;

package/src/core/soul/critic.ts

@@ -17,7 +17,7 @@
 
 import { estimateTokens } from "./projector.js";
 
-export type FailureMode = "wall-of-text" | "sycophancy" | "emoji-overload";
+type FailureMode = "wall-of-text" | "sycophancy" | "emoji-overload";
 
 export interface CritiqueFeatures {
   readonly tokens: number;

package/src/core/soul/embedder.ts

@@ -23,13 +23,13 @@ export interface Embedder {
 
 // ── Vector math ──────────────────────────────────────────────────────────────
 
-export function dot(a: readonly number[], b: readonly number[]): number {
+function dot(a: readonly number[], b: readonly number[]): number {
   let s = 0;
   for (let i = 0; i < a.length; i++) s += a[i]! * b[i]!;
   return s;
 }
 
-export function norm(a: readonly number[]): number {
+function norm(a: readonly number[]): number {
   return Math.sqrt(dot(a, a));
 }
 

package/src/core/soul/governance.ts

@@ -18,7 +18,7 @@ import { randomUUID } from "node:crypto";
 import { hashPayload } from "./hash.js";
 import type { NodePayload } from "./types.js";
 
-export type ProposalStatus = "pending" | "approved" | "rejected";
+type ProposalStatus = "pending" | "approved" | "rejected";
 
 export interface Proposal {
   readonly id: string;

package/src/core/soul/hdc.ts

@@ -25,7 +25,7 @@ import { createHash } from "node:crypto";
 
 export type Hypervector = Int8Array;
 
-export const DEFAULT_HD_DIM = 4096;
+const DEFAULT_HD_DIM = 4096;
 
 /** Deterministic ±1 hypervector for a symbol — the same token always maps here. */
 export function symbolVector(token: string, dim = DEFAULT_HD_DIM): Hypervector {

package/src/core/soul/reflex.ts

@@ -48,7 +48,7 @@ const DELIVERY_ACTIONS = new Set(["end_turn", "send", "react"]);
  * Keep them small and total; compound conditions get their own named predicate
  * rather than being expressed in the data.
  */
-export const BUILTIN_PREDICATES: Readonly<Record<string, ReflexPredicate>> = {
+const BUILTIN_PREDICATES: Readonly<Record<string, ReflexPredicate>> = {
   /** Always-on trigger. */
   always: () => true,
 
@@ -85,7 +85,7 @@ function resolve(
 }
 
 /** Evaluate one reflex against a context. */
-export function evaluateReflex(
+function evaluateReflex(
   reflex: ReflexPayload,
   ctx: ReflexContext,
   overrides?: Readonly<Record<string, ReflexPredicate>>,

package/src/core/soul/retrieve.ts

@@ -32,7 +32,7 @@ export interface RetrievalWeights {
   readonly relevance: number;
 }
 
-export const DEFAULT_RETRIEVAL_WEIGHTS: RetrievalWeights = {
+const DEFAULT_RETRIEVAL_WEIGHTS: RetrievalWeights = {
   recency: 1,
   importance: 1,
   relevance: 1,

package/src/core/soul/signals.ts

@@ -14,7 +14,7 @@
 
 import type { Hash } from "./types.js";
 
-export interface ReactionSignal {
+interface ReactionSignal {
   readonly kind: "reaction";
   readonly at: number;
   readonly emoji: string;
@@ -22,7 +22,7 @@ export interface ReactionSignal {
   readonly activeNodes: readonly Hash[];
 }
 
-export interface EngagementSignal {
+interface EngagementSignal {
   readonly kind: "engagement";
   readonly at: number;
   /** Did the conversation continue after Talon's message, or die? */
@@ -56,14 +56,14 @@ export interface DirectiveSignal {
   readonly ref?: string;
 }
 
-export interface ReflexFireSignal {
+interface ReflexFireSignal {
   readonly kind: "reflex-fire";
   readonly at: number;
   readonly name: string;
   readonly severity: "block" | "warn" | "advise";
 }
 
-export interface ActivationSignal {
+interface ActivationSignal {
   readonly kind: "activation";
   readonly at: number;
   readonly activeNodes: readonly Hash[];

package/src/core/soul/types.ts

@@ -45,7 +45,7 @@ export type NodeKind =
  * Where a piece of ground truth came from. Provenance is content, not metadata:
  * an evidence node's identity includes *who said it, when, and where*.
  */
-export interface EvidenceSource {
+interface EvidenceSource {
   /** Origin channel: a chat correction, a logged event, a diary line, etc. */
   readonly origin:
     | "correction" // someone (usually Dylan) corrected behavior

package/src/core/tasks/index.ts

@@ -10,11 +10,7 @@
 export { TaskTable, taskTable } from "./table.js";
 export type {
   KillOutcome,
-  TaskBinding,
   TaskHandle,
-  TaskKind,
   TaskRecord,
-  TaskSpec,
   TaskState,
-  TaskUsage,
 } from "./types.js";

package/src/core/tasks/types.ts

@@ -13,7 +13,7 @@
  */
 
 /** Which unit of agent work a task represents. */
-export type TaskKind = "turn" | "heartbeat" | "dream" | "cron" | "trigger";
+type TaskKind = "turn" | "heartbeat" | "dream" | "cron" | "trigger";
 
 /** Task lifecycle. `done`, `failed`, and `killed` are terminal. */
 export type TaskState = "queued" | "running" | "done" | "failed" | "killed";

package/src/core/tools/index.ts

@@ -241,9 +241,4 @@ export function composeTools(options: ComposeOptions = {}): ToolDefinition[] {
 }
 
 // Re-export types for convenience
-export type {
-  ToolDefinition,
-  ToolFrontend,
-  ToolTag,
-  BridgeFunction,
-} from "./types.js";
+export type { ToolDefinition } from "./types.js";