@moxxy/sdk 0.1.0

package/dist/compactor-helpers.js

@@ -0,0 +1,156 @@
+import { computeElisionState, conversationalStub, conversationalStubbed, toolResultBytes, toolResultStub, toolResultStubbed, } from './elision-state.js';
+/**
+ * Cheap, no-network estimate of how many tokens the current event log
+ * would consume on the next provider request. Char-based (chars/4) with
+ * compaction events honored — events covered by a CompactionEvent.replacedRange
+ * count as the (much shorter) summary rather than their original bytes — and
+ * elision honored: old tool results (seq ≤ the elision high-water mark) count
+ * as their ~stub size rather than their full payload, matching what
+ * `projectMessagesFromLog` actually sends.
+ *
+ * Used by the auto-compact helper (see `runCompactionIfNeeded`) and by
+ * the TUI's context meter. For perfect accuracy callers can use the
+ * provider's `countTokens(req)`; this is the fast path that doesn't
+ * touch the network and is safe to run on every iteration.
+ */
+export function estimateContextTokens(log) {
+    const events = log.slice();
+    // Share the exact stub decision with projection so the estimate matches what
+    // is actually sent — pinned recalls / never-elide / tiny turns counted full,
+    // not undercounted (which would let the context overflow before compaction).
+    const el = computeElisionState(events);
+    let chars = 0;
+    const compactedSeqs = new Set();
+    for (const e of events) {
+        if (e.type === 'compaction') {
+            for (let seq = e.replacedRange[0]; seq <= e.replacedRange[1]; seq++) {
+                compactedSeqs.add(seq);
+            }
+            chars += e.summary.length;
+        }
+    }
+    for (const e of events) {
+        if (compactedSeqs.has(e.seq))
+            continue;
+        if (e.type === 'tool_result' && toolResultStubbed(e, el)) {
+            const recalled = el.recalledCallIds.has(e.callId) || el.recalledSeqs.has(e.seq);
+            chars += toolResultStub(e.callId, toolResultBytes(e.output), recalled).length;
+            continue;
+        }
+        if ((e.type === 'user_prompt' || e.type === 'assistant_message') && conversationalStubbed(e, el)) {
+            chars += conversationalStub(e.type === 'user_prompt' ? 'user' : 'assistant', e.seq).length;
+            continue;
+        }
+        chars += eventChars(e);
+    }
+    return Math.ceil(chars / 4);
+}
+function eventChars(e) {
+    switch (e.type) {
+        case 'user_prompt':
+            return e.text.length;
+        case 'assistant_message':
+            return e.content.length;
+        case 'tool_call_requested':
+            return e.name.length + safeJsonLen(e.input);
+        case 'tool_result':
+            if (e.error)
+                return (e.error.message?.length ?? 0) + 12;
+            if (typeof e.output === 'string')
+                return e.output.length;
+            return safeJsonLen(e.output);
+        default:
+            return 0;
+    }
+}
+function safeJsonLen(v) {
+    try {
+        return JSON.stringify(v ?? '').length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Auto-compaction hook every mode calls once per iteration, right
+ * before building messages for the next provider call. Reads the
+ * active model's real `contextWindow` (not a magic max-int sentinel),
+ * estimates current token use, and — if the configured compactor's
+ * `shouldCompact` returns true — runs `compact()` and emits the
+ * resulting CompactionEvent onto the log. `projectMessagesFromLog`
+ * already honors compaction events, so the next provider call sees
+ * the summarized prefix automatically.
+ *
+ * Designed to be tolerant: no compactor, no model descriptor, no
+ * contextWindow, or a compactor throw all degrade to a no-op so a
+ * compactor bug can't kill the turn. Failures emit a non-fatal
+ * `error` event for observability.
+ */
+export async function runCompactionIfNeeded(ctx) {
+    const compactor = ctx.compactor;
+    if (!compactor)
+        return;
+    // Resolve the active model's descriptor so we use the *real* context
+    // window. `Number.MAX_SAFE_INTEGER` (the old /compact behavior) made
+    // threshold-based compactors always look comfortable, even at 99%.
+    const descriptor = ctx.provider.models.find((m) => m.id === ctx.model);
+    const contextWindow = descriptor?.contextWindow;
+    if (!contextWindow || contextWindow <= 0)
+        return;
+    const events = ctx.log.slice();
+    if (events.length === 0)
+        return;
+    const budget = {
+        contextWindow,
+        estimatedTokens: estimateContextTokens(ctx.log),
+        reserveForOutput: descriptor?.maxOutputTokens ?? 0,
+    };
+    let shouldRun = false;
+    try {
+        shouldRun = compactor.shouldCompact(ctx.log, budget);
+    }
+    catch (err) {
+        await ctx.emit({
+            type: 'error',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            kind: 'retryable',
+            message: `compactor.shouldCompact threw: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        return;
+    }
+    if (!shouldRun)
+        return;
+    try {
+        const result = await compactor.compact(events, {
+            log: ctx.log,
+            budget,
+            signal: ctx.signal,
+        });
+        if (result.tokensSaved <= 0 || result.summary.trim().length === 0)
+            return;
+        // `compactor.compact` declares `Omit<CompactionEvent, keyof EventBase>`,
+        // but every shipped compactor (and the SDK examples) fills sessionId /
+        // turnId / source. Defensive-fill from ctx so a compactor that obeyed
+        // the type contract literally still emits a valid event.
+        const emittable = {
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'compactor',
+            ...result,
+        };
+        await ctx.emit(emittable);
+    }
+    catch (err) {
+        await ctx.emit({
+            type: 'error',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            kind: 'retryable',
+            message: `compactor.compact threw: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+}
+//# sourceMappingURL=compactor-helpers.js.map

package/dist/compactor-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor-helpers.js","sourceRoot":"","sources":["../src/compactor-helpers.ts"],"names":[],"mappings":"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"}

package/dist/compactor.d.ts

@@ -0,0 +1,20 @@
+import type { CompactionEvent, MoxxyEvent } from './events.js';
+import type { EventLogReader } from './log.js';
+export interface TokenBudget {
+    readonly contextWindow: number;
+    readonly estimatedTokens: number;
+    readonly reserveForOutput: number;
+}
+export interface CompactContext {
+    readonly log: EventLogReader;
+    readonly budget: TokenBudget;
+    readonly signal: AbortSignal;
+}
+export interface CompactorDef {
+    readonly name: string;
+    shouldCompact(log: EventLogReader, budget: TokenBudget): boolean;
+    compact(events: ReadonlyArray<MoxxyEvent>, ctx: CompactContext): Promise<Omit<CompactionEvent, keyof import('./events.js').EventBase> & {
+        ts?: number;
+    }>;
+}
+//# sourceMappingURL=compactor.d.ts.map

package/dist/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../src/compactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IACjE,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,OAAO,aAAa,EAAE,SAAS,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1J"}

package/dist/compactor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compactor.js.map

package/dist/compactor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.js","sourceRoot":"","sources":["../src/compactor.ts"],"names":[],"mappings":""}

package/dist/define.d.ts

@@ -0,0 +1,51 @@
+import type { AgentDef } from './agent.js';
+import type { CacheStrategyDef } from './cache-strategy.js';
+import type { ChannelDef } from './channel.js';
+import type { CommandDef } from './command.js';
+import type { CompactorDef } from './compactor.js';
+import type { ModeDef } from './mode.js';
+import type { PermissionRule } from './permission.js';
+import type { Plugin, PluginSpec } from './plugin.js';
+import type { ProviderDef } from './provider.js';
+import type { SkillDef, SkillFrontmatter } from './skill.js';
+import type { ToolCompactPresentation, ToolContext, ToolDef } from './tool.js';
+import type { ToolIsolationSpec } from './isolation.js';
+import type { TranscriberDef } from './transcriber.js';
+import type { ViewRendererDef } from './view-renderer.js';
+import type { TunnelProviderDef } from './tunnel.js';
+import type { z } from 'zod';
+export declare function definePlugin(spec: PluginSpec): Plugin;
+/**
+ * `defineTool` carries an extra generic `<S, O>` so the `handler`'s `input`
+ * parameter is typed as `z.output<S>` rather than `unknown` — that's the
+ * authoring-ergonomics benefit. The returned `ToolDef` widens the handler
+ * to the runtime contract `(unknown, ToolContext) => unknown` because the
+ * registry parses input via `inputSchema` before calling.
+ */
+export declare function defineTool<S extends z.ZodTypeAny, O = unknown>(spec: {
+    name: string;
+    description: string;
+    inputSchema: S;
+    inputJsonSchema?: unknown;
+    outputSchema?: z.ZodType<O>;
+    permission?: PermissionRule;
+    handler: (input: z.output<S>, ctx: ToolContext) => Promise<O> | O;
+    compact?: ToolCompactPresentation;
+    isolation?: ToolIsolationSpec;
+}): ToolDef;
+export declare function defineProvider(spec: ProviderDef): ProviderDef;
+export declare function defineMode(spec: ModeDef): ModeDef;
+export declare function defineCompactor(spec: CompactorDef): CompactorDef;
+export declare function defineCacheStrategy(spec: CacheStrategyDef): CacheStrategyDef;
+export declare function defineViewRenderer(spec: ViewRendererDef): ViewRendererDef;
+export declare function defineTunnelProvider(spec: TunnelProviderDef): TunnelProviderDef;
+export declare function defineChannel<TStartOpts = unknown>(spec: ChannelDef<TStartOpts>): ChannelDef<TStartOpts>;
+export declare function definePermission(spec: PermissionRule): PermissionRule;
+export declare function defineSkill(spec: {
+    frontmatter: SkillFrontmatter;
+    body: string;
+}): SkillDef;
+export declare function defineTranscriber(spec: TranscriberDef): TranscriberDef;
+export declare function defineCommand(spec: CommandDef): CommandDef;
+export declare function defineAgent(spec: AgentDef): AgentDef;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}

package/dist/define.js

@@ -0,0 +1,71 @@
+export function definePlugin(spec) {
+    // Spread spec first so the defaults below can't be clobbered by an
+    // explicit `version: undefined` in the spec (which violates Plugin.version
+    // typed as `string`).
+    return Object.freeze({
+        ...spec,
+        __moxxy: 'plugin',
+        version: spec.version ?? '0.0.0',
+    });
+}
+/**
+ * `defineTool` carries an extra generic `<S, O>` so the `handler`'s `input`
+ * parameter is typed as `z.output<S>` rather than `unknown` — that's the
+ * authoring-ergonomics benefit. The returned `ToolDef` widens the handler
+ * to the runtime contract `(unknown, ToolContext) => unknown` because the
+ * registry parses input via `inputSchema` before calling.
+ */
+export function defineTool(spec) {
+    return Object.freeze({
+        name: spec.name,
+        description: spec.description,
+        inputSchema: spec.inputSchema,
+        inputJsonSchema: spec.inputJsonSchema,
+        outputSchema: spec.outputSchema,
+        permission: spec.permission,
+        handler: spec.handler,
+        compact: spec.compact,
+        isolation: spec.isolation,
+    });
+}
+// Every other `defineX` follows the same `(spec: XDef): XDef` shape: it
+// freezes the spec and hands it back. The compile-time win is a clean
+// "this is how you author one" signature; the runtime win is
+// Object.freeze so plugin authors can't mutate published defs.
+export function defineProvider(spec) {
+    return Object.freeze(spec);
+}
+export function defineMode(spec) {
+    return Object.freeze(spec);
+}
+export function defineCompactor(spec) {
+    return Object.freeze(spec);
+}
+export function defineCacheStrategy(spec) {
+    return Object.freeze(spec);
+}
+export function defineViewRenderer(spec) {
+    return Object.freeze(spec);
+}
+export function defineTunnelProvider(spec) {
+    return Object.freeze(spec);
+}
+export function defineChannel(spec) {
+    return Object.freeze(spec);
+}
+export function definePermission(spec) {
+    return Object.freeze(spec);
+}
+export function defineSkill(spec) {
+    return Object.freeze(spec);
+}
+export function defineTranscriber(spec) {
+    return Object.freeze(spec);
+}
+export function defineCommand(spec) {
+    return Object.freeze(spec);
+}
+export function defineAgent(spec) {
+    return Object.freeze(spec);
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,mEAAmE;IACnE,2EAA2E;IAC3E,sBAAsB;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,OAAO,EAAE,QAAiB;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;KACjC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAsC,IAU/D;IACC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAA2E;QACzF,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,wEAAwE;AACxE,sEAAsE;AACtE,6DAA6D;AAC7D,+DAA+D;AAE/D,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAsB;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAA4B;IAE5B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAoB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAqD;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAoB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/elision-helpers.d.ts

@@ -0,0 +1,27 @@
+import type { ElisionSettings, ModeContext } from './mode.js';
+/**
+ * Turn-boundary elision (context-on-demand). Called once per loop iteration by
+ * every mode, right next to `runCompactionIfNeeded`. When the recent window
+ * exceeds `keepRecentTurns` AND the context is at least `minContextRatioToElide`
+ * full, it advances a high-water mark (in whole-turn steps) by appending an
+ * `ElisionEvent`. `projectMessagesFromLog` then renders events at or below that
+ * mark as compact stubs the model can expand via the `recall` tool.
+ *
+ * Hard invariants (independent of config): never elide the in-progress turn,
+ * never elide the first user_prompt (task anchor — enforced in projection),
+ * and degrade to a no-op on any internal error so an elision bug can't kill a
+ * turn. The mark only advances on completed-turn boundaries, which keeps the
+ * elided prefix byte-stable across a turn's iterations so caching still hits.
+ */
+export interface ResolvedElisionSettings {
+    readonly enabled: boolean;
+    readonly keepRecentTurns: number;
+    readonly minContextRatioToElide: number;
+    readonly elideConversational: boolean;
+    readonly conversationalRecallThreshold: number;
+    readonly maxRecallBytes: number;
+    readonly neverElideTools: ReadonlyArray<string>;
+}
+export declare function resolveElisionSettings(s?: ElisionSettings): ResolvedElisionSettings;
+export declare function runElisionIfNeeded(ctx: ModeContext): Promise<void>;
+//# sourceMappingURL=elision-helpers.d.ts.map

package/dist/elision-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elision-helpers.d.ts","sourceRoot":"","sources":["../src/elision-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjD;AAgBD,wBAAgB,sBAAsB,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,uBAAuB,CAYnF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DxE"}

package/dist/elision-helpers.js

@@ -0,0 +1,109 @@
+import { estimateContextTokens } from './compactor-helpers.js';
+import { toolResultBytes } from './elision-state.js';
+const DEFAULTS = {
+    enabled: true,
+    keepRecentTurns: 4,
+    minContextRatioToElide: 0.3,
+    // User-selected default: aggressive context-on-demand (collapse old text
+    // turns too), but with adaptive auto-disable below.
+    elideConversational: true,
+    // After this many seq-based recalls, conversational elision switches off for
+    // the session (the model is clearly leaning on elided text turns).
+    conversationalRecallThreshold: 4,
+    maxRecallBytes: 32_768,
+    neverElideTools: [],
+};
+export function resolveElisionSettings(s) {
+    return {
+        enabled: s?.enabled ?? DEFAULTS.enabled,
+        // Hard floor: never keep fewer than 2 recent turns verbatim.
+        keepRecentTurns: Math.max(2, s?.keepRecentTurns ?? DEFAULTS.keepRecentTurns),
+        minContextRatioToElide: s?.minContextRatioToElide ?? DEFAULTS.minContextRatioToElide,
+        elideConversational: s?.elideConversational ?? DEFAULTS.elideConversational,
+        conversationalRecallThreshold: s?.conversationalRecallThreshold ?? DEFAULTS.conversationalRecallThreshold,
+        maxRecallBytes: s?.maxRecallBytes ?? DEFAULTS.maxRecallBytes,
+        neverElideTools: s?.neverElideTools ?? DEFAULTS.neverElideTools,
+    };
+}
+export async function runElisionIfNeeded(ctx) {
+    try {
+        const s = resolveElisionSettings(ctx.elision);
+        if (!s.enabled)
+            return;
+        const descriptor = ctx.provider.models.find((m) => m.id === ctx.model);
+        const contextWindow = descriptor?.contextWindow;
+        if (!contextWindow || contextWindow <= 0)
+            return;
+        // Gate: below this fill the whole history fits comfortably — eliding would
+        // only add missed-context risk for no token benefit.
+        if (estimateContextTokens(ctx.log) < s.minContextRatioToElide * contextWindow)
+            return;
+        const events = ctx.log.slice();
+        if (events.length === 0)
+            return;
+        const priorHWM = events.reduce((max, e) => (e.type === 'elision' ? Math.max(max, e.elidedThrough) : max), -1);
+        // Distinct COMPLETED turns in order (exclude the in-progress turn).
+        const turnOrder = [];
+        const seen = new Set();
+        for (const e of events) {
+            if (e.turnId === ctx.turnId)
+                continue;
+            if (!seen.has(e.turnId)) {
+                seen.add(e.turnId);
+                turnOrder.push(e.turnId);
+            }
+        }
+        if (turnOrder.length <= s.keepRecentTurns)
+            return;
+        // Elide every completed turn before the recent window.
+        const elideTurns = new Set(turnOrder.slice(0, turnOrder.length - s.keepRecentTurns));
+        let to = -1;
+        for (const e of events) {
+            if (elideTurns.has(e.turnId))
+                to = Math.max(to, e.seq);
+        }
+        if (to <= priorHWM)
+            return; // nothing new to elide
+        const from = priorHWM + 1;
+        const tokensSaved = estimateElisionSavings(events, from, to, s.neverElideTools);
+        const emittable = {
+            type: 'elision',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            elidedThrough: to,
+            stubbedRanges: [[from, to]],
+            elideConversational: s.elideConversational,
+            conversationalRecallThreshold: s.conversationalRecallThreshold,
+            maxRecallBytes: s.maxRecallBytes,
+            neverElideTools: s.neverElideTools,
+            tokensSaved,
+        };
+        await ctx.emit(emittable);
+    }
+    catch {
+        // Elision is best-effort; a bug here must never kill the turn.
+    }
+}
+function estimateElisionSavings(events, from, to, neverElide) {
+    const neverSet = new Set(neverElide);
+    const toolNameByCall = new Map();
+    for (const e of events) {
+        if (e.type === 'tool_call_requested')
+            toolNameByCall.set(e.callId, e.name);
+    }
+    let savedChars = 0;
+    for (const e of events) {
+        if (e.seq < from || e.seq > to)
+            continue;
+        if (e.type === 'tool_result' && !e.error) {
+            const name = toolNameByCall.get(e.callId);
+            if (name && neverSet.has(name))
+                continue;
+            const bytes = toolResultBytes(e.output);
+            savedChars += Math.max(0, bytes - 60); // stub is ~60 chars
+        }
+    }
+    return Math.ceil(savedChars / 4);
+}
+//# sourceMappingURL=elision-helpers.js.map

package/dist/elision-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elision-helpers.js","sourceRoot":"","sources":["../src/elision-helpers.ts"],"names":[],"mappings":"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"}

package/dist/elision-state.d.ts

@@ -0,0 +1,49 @@
+import type { MoxxyEvent } from './events.js';
+/**
+ * Shared elision decision logic — the single source of truth for "is this event
+ * stubbed, and to what size", consumed by BOTH `projectMessagesFromLog` (what we
+ * send) and `estimateContextTokens` (what we think we send). Keeping them in one
+ * leaf module guarantees the estimate matches reality (no overflow from
+ * undercounting pinned recalls) and avoids a circular import between the
+ * projection and the estimate.
+ */
+/** Below this size, eliding a turn/result saves nothing — keep it verbatim. */
+export declare const TINY_TURN_CHARS = 200;
+/** Bytes of a tool_result payload (for stub labels + the recall cap). */
+export declare function toolResultBytes(output: unknown, errorMessage?: string): number;
+/** Deterministic stub for an elided tool result. Stable bytes → cache-safe. */
+export declare function toolResultStub(callId: string, bytes: number, recalled: boolean): string;
+/** Deterministic stub for an elided conversational (user/assistant) turn. */
+export declare function conversationalStub(role: 'user' | 'assistant', seq: number): string;
+export interface ElisionState {
+    /** Inclusive seq high-water mark; -1 when no elision is active. */
+    readonly hwm: number;
+    /** Conversational elision after the adaptive auto-disable check. */
+    readonly effectiveElideConversational: boolean;
+    readonly neverElide: ReadonlySet<string>;
+    readonly toolNameByCall: ReadonlyMap<string, string>;
+    /** callIds an earlier `recall` referenced (their stub says "already recalled"). */
+    readonly recalledCallIds: ReadonlySet<string>;
+    readonly recalledSeqs: ReadonlySet<number>;
+    /** callIds whose tool_result IS a recall's output — pinned verbatim... */
+    readonly recallResultCallIds: ReadonlySet<string>;
+    /** ...except these, which exceeded `maxRecallBytes` and get stubbed. */
+    readonly unpinnedRecallCallIds: ReadonlySet<string>;
+    /** Seq of the first user_prompt (task anchor) — never elided. */
+    readonly firstUserPromptSeq: number;
+}
+/**
+ * Derive elision state purely from the log: the active high-water mark + flags
+ * (from the latest ElisionEvent), the callId→tool map, recall bookkeeping, the
+ * adaptive conversational auto-disable, and which pinned recalls exceed the cap.
+ */
+export declare function computeElisionState(events: ReadonlyArray<MoxxyEvent>): ElisionState;
+/** Is this tool_result sent as a stub? (Shared by projection + estimate.) */
+export declare function toolResultStubbed(e: Extract<MoxxyEvent, {
+    type: 'tool_result';
+}>, state: ElisionState): boolean;
+/** Is this user/assistant turn collapsed to a conversational stub? */
+export declare function conversationalStubbed(e: Extract<MoxxyEvent, {
+    type: 'user_prompt' | 'assistant_message';
+}>, state: ElisionState): boolean;
+//# sourceMappingURL=elision-state.d.ts.map

package/dist/elision-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elision-state.d.ts","sourceRoot":"","sources":["../src/elision-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ9E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAIvF;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,wEAAwE;IACxE,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAcD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,YAAY,CAqEnF;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,EAC/C,KAAK,EAAE,YAAY,GAClB,OAAO,CAUT;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAAA;CAAE,CAAC,EACrE,KAAK,EAAE,YAAY,GAClB,OAAO,CAMT"}