@moxxy/core 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# @moxxy/core
+
+The [moxxy](https://moxxy.ai) runtime, as a library. Construct an agentic
+**Session**, register the blocks you want (providers, tools, modes, compactors,
+channels, …), and run turns — embed moxxy's agent loop directly in your own code
+instead of going through the CLI or desktop app.
+
+`@moxxy/core` is the **engine + the block registries**. It ships *no* built-in
+LLM provider or loop strategy — those are swappable packages you register, so
+nothing is welded in.
+
+> **Just want to run an agent fast?** Use
+> [`@moxxy/agent`](https://www.npmjs.com/package/@moxxy/agent) —
+> `setupAgent(openaiPreset({ apiKey }))` and you're done. This package is the
+> layer underneath, for when you want full control of the blocks.
+
+## Install
+
+```bash
+npm i @moxxy/core @moxxy/sdk @moxxy/mode-default @moxxy/plugin-provider-openai
+```
+
+(`@moxxy/sdk` gives you the typed contracts + `define*` factories for authoring
+your own blocks.)
+
+## Quick start — `setupAgent`
+
+`setupAgent` wires a Session + your blocks in one synchronous call and hands back
+a small agent you destructure:
+
+```ts
+import { setupAgent } from '@moxxy/core';
+import defaultMode from '@moxxy/mode-default';
+import openai from '@moxxy/plugin-provider-openai';
+
+const { ask, stream, session } = setupAgent({
+  plugins: [defaultMode, openai],
+  provider: { name: 'openai', config: { apiKey: process.env.OPENAI_API_KEY } },
+});
+
+// `ask` → the final reply text (async):
+console.log(await ask('Say hello in French.'));
+
+// `stream` → an async generator yielding each event:
+for await (const event of stream('Now in German.')) {
+  if (event.type === 'assistant_chunk') process.stdout.write(event.delta);
+}
+```
+
+`collect(prompt)` resolves with every event; `session` is the live Session for
+anything the sugar doesn't cover.
+
+### Tools
+
+```ts
+import { defineTool } from '@moxxy/sdk';
+import { z } from 'zod';
+
+const { ask, addTool } = setupAgent({ plugins: [defaultMode, openai], provider: { name: 'openai' } });
+
+addTool(
+  defineTool({
+    name: 'get_weather',
+    description: 'Current weather for a city.',
+    inputSchema: z.object({ city: z.string() }),
+    handler: async ({ city }) => `It's sunny in ${city}.`,
+  }),
+);
+
+console.log(await ask("What's the weather in Paris?"));
+```
+
+### Hot-swap blocks between turns
+
+Nothing is hardcoded — the registries *are* the enable/disable/swap mechanism,
+exposed as chainable sugar (and on `agent.session` directly):
+
+```ts
+agent.setProvider('anthropic', { apiKey: process.env.ANTHROPIC_API_KEY }); // swap LLM
+agent.setMode('goal');                                                     // swap loop strategy
+agent.removeTool('get_weather');
+await agent.discover();                                                     // load npm plugins
+```
+
+## Under the hood (manual wiring)
+
+`setupAgent` is sugar over the raw API, which you can use directly:
+
+```ts
+import { Session, runTurn, autoAllowResolver } from '@moxxy/core';
+
+const session = new Session({ cwd: process.cwd(), permissionResolver: autoAllowResolver });
+session.pluginHost.registerStatic(defaultMode);
+session.pluginHost.registerStatic(openai);
+session.providers.setActive('openai', { apiKey: process.env.OPENAI_API_KEY });
+
+for await (const event of runTurn(session, 'Summarise the files in this repo.')) {
+  // …
+}
+```
+
+## What's in the box
+
+`setupAgent` + `Session` + `runTurn`/`collectTurn` · the registries
+(`ProviderRegistry`, `ToolRegistryImpl`, `ModeRegistry`, `CompactorRegistry`,
+`CacheStrategyRegistry`, `ChannelRegistryImpl`, `EmbedderRegistry`, …) ·
+`PluginHost` + plugin discovery/loading · `SessionPersistence` (save / resume) ·
+the `PermissionEngine` + resolvers (`autoAllowResolver`, `denyByDefaultResolver`,
+allow-list, callback) · the `EventLog` · skills · `createLogger`. The
+`@moxxy/sdk` types in the public surface (`MoxxyEvent`, `Plugin`, `ToolDef`,
+`PermissionResolver`, `RunTurnOptions`) are re-exported, so the API is fully
+typed from a single import.
+
+`packages/core/src/index.ts` is the curated public surface. The package is `0.x`:
+the API may still change between minor versions while it settles.
+
+## You bring the model
+
+`@moxxy/core` is provider-agnostic: it defines the `LLMProvider` contract (in
+`@moxxy/sdk`) but bundles no vendor. Register a provider plugin (or your own)
+before running a turn.
+
+## License
+
+MIT

package/dist/events/factory.d.ts

@@ -0,0 +1,6 @@
+import type { EventId, EmittedEvent, MoxxyEvent, SessionId, TurnId } from '@moxxy/sdk';
+export declare const newEventId: () => EventId;
+export declare const newTurnId: () => TurnId;
+export declare const newSessionId: () => SessionId;
+export declare function materializeEvent(partial: EmittedEvent, seq: number, now?: () => number): MoxxyEvent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/events/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/events/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,OAAO,EACP,YAAY,EACZ,UAAU,EACV,SAAS,EACT,MAAM,EACP,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,UAAU,QAAO,OAA4B,CAAC;AAC3D,eAAO,MAAM,SAAS,QAAO,MAA0B,CAAC;AACxD,eAAO,MAAM,YAAY,QAAO,SAAgC,CAAC;AAEjE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,MAAiB,GAC3B,UAAU,CAOZ"}

package/dist/events/factory.js

@@ -0,0 +1,14 @@
+import { ulid } from 'ulid';
+import { asEventId, asSessionId, asTurnId } from '@moxxy/sdk';
+export const newEventId = () => asEventId(ulid());
+export const newTurnId = () => asTurnId(ulid());
+export const newSessionId = () => asSessionId(ulid());
+export function materializeEvent(partial, seq, now = Date.now) {
+    const base = {
+        id: newEventId(),
+        seq,
+        ts: partial.ts ?? now(),
+    };
+    return { ...partial, ...base };
+}
+//# sourceMappingURL=factory.js.map

package/dist/events/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/events/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;AAEjE,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,GAAW,EACX,MAAoB,IAAI,CAAC,GAAG;IAE5B,MAAM,IAAI,GAAyC;QACjD,EAAE,EAAE,UAAU,EAAE;QAChB,GAAG;QACH,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,EAAE;KACxB,CAAC;IACF,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAgB,CAAC;AAC/C,CAAC"}

package/dist/events/log.d.ts

@@ -0,0 +1,92 @@
+import type { EmittedEvent, EventLogReader, MoxxyEvent, MoxxyEventOfType, MoxxyEventType, TurnId } from '@moxxy/sdk';
+export type EventListener = (event: MoxxyEvent) => void | Promise<void>;
+export declare class EventLog implements EventLogReader {
+    private readonly events;
+    private readonly listeners;
+    private readonly clearListeners;
+    private readonly now;
+    /**
+     * Lazy secondary indexes so `ofType`/`byTurn` are O(matches) instead of an
+     * O(n) full-array `filter` per call (these back hot paths: token-accounting's
+     * `ofType('provider_response')`, lazy-tool gating's
+     * `ofType('tool_call_requested')`, and remote-session's per-turn
+     * `byTurn(turnId)` priming). Built lazily on first query so a cold/seeded log
+     * pays the one-time O(n) build only if anything ever queries it, then kept
+     * O(1) per append/ingest. Reset to `null` (rebuild-on-next-query) by
+     * `clear`/`rebase`, which mutate `events` wholesale.
+     *
+     * Each index holds the SAME event object references in their original
+     * append order — so a query returns an array deep-equal to the old
+     * `events.filter(...)` for every input.
+     */
+    private byType;
+    private byTurnId;
+    /**
+     * Seq of the FIRST event this log holds. 0 for an authoring log; a mirror
+     * primed by a partial attach replay (runner protocol v6 `replay.start`)
+     * rebases to the first replayed seq so `ingest`'s contiguity gate lines up
+     * with the runner's stream instead of expecting history we never received.
+     * `seq === base + index` for every held event.
+     */
+    private base;
+    constructor(seed?: ReadonlyArray<MoxxyEvent>, opts?: {
+        now?: () => number;
+    });
+    get length(): number;
+    /** Seq of the first held event (see {@link rebase}). */
+    get baseSeq(): number;
+    at(seq: number): MoxxyEvent | undefined;
+    slice(from?: number, to?: number): ReadonlyArray<MoxxyEvent>;
+    /** Build both secondary indexes from the current `events` array, preserving
+     * append order. Bucket arrays hold the original event references. */
+    private buildIndexes;
+    /** Append one event to the live indexes (no-op while they're cold). Called
+     * after the event is pushed to `events`, so order is preserved. */
+    private indexEvent;
+    ofType<T extends MoxxyEventType>(type: T): ReadonlyArray<MoxxyEventOfType<T>>;
+    byTurn(turnId: TurnId): ReadonlyArray<MoxxyEvent>;
+    toJSON(): ReadonlyArray<MoxxyEvent>;
+    append(partial: EmittedEvent): Promise<MoxxyEvent>;
+    subscribe(fn: EventListener): () => void;
+    /**
+     * Append an already-materialized event, preserving its `id`/`seq`/`ts`
+     * rather than minting new ones. This is how a thin client mirrors the
+     * runner's log: the server is the sole authority for event identity, so the
+     * mirror must keep the originals. De-dupes by `seq` (idempotent replay) and
+     * fires listeners fire-and-forget - a mirror has no dispatcher to await.
+     *
+     * Not for normal authoring; use {@link append} for that.
+     */
+    ingest(event: MoxxyEvent): void;
+    /**
+     * Start this (empty) log at `seq` instead of 0. A mirror primed by a
+     * PARTIAL attach replay (`replay: 'none'` / `{ tail }`) calls this with the
+     * runner's announced first seq so {@link ingest}'s contiguity gate accepts
+     * the stream. Only valid while empty — rebasing held events would detach
+     * their seqs from their indices.
+     */
+    rebase(seq: number): void;
+    /**
+     * Drop every event from the log. Used by `/new` to start a fresh
+     * session without rebuilding the entire Session object — the
+     * registries, resolvers, and active provider stay; only the
+     * conversation context vanishes. Per-event listeners are NOT
+     * notified (there's no "event removed" event in the schema), but
+     * {@link onClear} subscribers fire — that's how the persistence
+     * sidecar truncates its JSONL (so `--resume` can't resurrect wiped
+     * history) and how the runner broadcasts a reset to attached
+     * mirrors, in lockstep with the wipe.
+     *
+     * Safe to call only when no turn is in flight — callers should abort
+     * their AbortController and await any pending runTurn() first.
+     */
+    clear(): void;
+    /**
+     * Subscribe to {@link clear}. Fires synchronously after the events array
+     * empties, so a listener reading the log observes the post-wipe state.
+     * Returns the unsubscribe callback.
+     */
+    onClear(fn: () => void): () => void;
+    asReader(): EventLogReader;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/events/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/events/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,MAAM,EACP,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,qBAAa,QAAS,YAAW,cAAc;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,MAAM,CAAkD;IAChE,OAAO,CAAC,QAAQ,CAA0C;IAC1D;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,CAAK;gBAEL,IAAI,GAAE,aAAa,CAAC,UAAU,CAAM,EAAE,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAWnF,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAMvC,KAAK,CAAC,IAAI,SAAI,EAAE,EAAE,GAAE,MAAuC,GAAG,aAAa,CAAC,UAAU,CAAC;IAMvF;yEACqE;IACrE,OAAO,CAAC,YAAY;IAepB;uEACmE;IACnE,OAAO,CAAC,UAAU;IAalB,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAW7E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IAMjD,MAAM,IAAI,aAAa,CAAC,UAAU,CAAC;IAI7B,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBxD,SAAS,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,IAAI;IAKxC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA2B/B;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAczB;;;;;;;;;;;;;OAaG;IACH,KAAK,IAAI,IAAI;IAoBb;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKnC,QAAQ,IAAI,cAAc;CAG3B"}

package/dist/events/log.js

@@ -0,0 +1,244 @@
+import { materializeEvent } from './factory.js';
+export class EventLog {
+    events = [];
+    listeners = new Set();
+    clearListeners = new Set();
+    now;
+    /**
+     * Lazy secondary indexes so `ofType`/`byTurn` are O(matches) instead of an
+     * O(n) full-array `filter` per call (these back hot paths: token-accounting's
+     * `ofType('provider_response')`, lazy-tool gating's
+     * `ofType('tool_call_requested')`, and remote-session's per-turn
+     * `byTurn(turnId)` priming). Built lazily on first query so a cold/seeded log
+     * pays the one-time O(n) build only if anything ever queries it, then kept
+     * O(1) per append/ingest. Reset to `null` (rebuild-on-next-query) by
+     * `clear`/`rebase`, which mutate `events` wholesale.
+     *
+     * Each index holds the SAME event object references in their original
+     * append order — so a query returns an array deep-equal to the old
+     * `events.filter(...)` for every input.
+     */
+    byType = null;
+    byTurnId = null;
+    /**
+     * Seq of the FIRST event this log holds. 0 for an authoring log; a mirror
+     * primed by a partial attach replay (runner protocol v6 `replay.start`)
+     * rebases to the first replayed seq so `ingest`'s contiguity gate lines up
+     * with the runner's stream instead of expecting history we never received.
+     * `seq === base + index` for every held event.
+     */
+    base = 0;
+    constructor(seed = [], opts = {}) {
+        this.now = opts.now ?? Date.now;
+        for (const e of seed)
+            this.events.push(e);
+        // Align `base` to the first seeded event so `seq === base + index` holds
+        // regardless of where the seed starts. Today every caller seeds a log
+        // re-sequenced to 0..n-1 (so this is a no-op), but a caller seeding a tail
+        // slice (e.g. seq 50..) would otherwise get silently wrong at()/slice()
+        // seq-addressing and an off-by-`base` ingest() contiguity gate.
+        if (seed.length > 0)
+            this.base = seed[0].seq;
+    }
+    get length() {
+        return this.events.length;
+    }
+    /** Seq of the first held event (see {@link rebase}). */
+    get baseSeq() {
+        return this.base;
+    }
+    at(seq) {
+        const index = seq - this.base;
+        if (index < 0 || index >= this.events.length)
+            return undefined;
+        return this.events[index];
+    }
+    slice(from = 0, to = this.base + this.events.length) {
+        // Seq-addressed, like `at`. Events below the base were never held, so a
+        // `from` before it just clamps to everything we have.
+        return this.events.slice(Math.max(0, from - this.base), Math.max(0, to - this.base));
+    }
+    /** Build both secondary indexes from the current `events` array, preserving
+     * append order. Bucket arrays hold the original event references. */
+    buildIndexes() {
+        const byType = new Map();
+        const byTurnId = new Map();
+        for (const e of this.events) {
+            let typeBucket = byType.get(e.type);
+            if (!typeBucket)
+                byType.set(e.type, (typeBucket = []));
+            typeBucket.push(e);
+            let turnBucket = byTurnId.get(e.turnId);
+            if (!turnBucket)
+                byTurnId.set(e.turnId, (turnBucket = []));
+            turnBucket.push(e);
+        }
+        this.byType = byType;
+        this.byTurnId = byTurnId;
+    }
+    /** Append one event to the live indexes (no-op while they're cold). Called
+     * after the event is pushed to `events`, so order is preserved. */
+    indexEvent(e) {
+        if (this.byType) {
+            const bucket = this.byType.get(e.type);
+            if (bucket)
+                bucket.push(e);
+            else
+                this.byType.set(e.type, [e]);
+        }
+        if (this.byTurnId) {
+            const bucket = this.byTurnId.get(e.turnId);
+            if (bucket)
+                bucket.push(e);
+            else
+                this.byTurnId.set(e.turnId, [e]);
+        }
+    }
+    ofType(type) {
+        if (!this.byType)
+            this.buildIndexes();
+        // The bucket already holds exactly the matching events in append order —
+        // identical to the old `events.filter(e => e.type === type)`. Return a copy
+        // so callers can't mutate the index (filter() also returned a fresh array).
+        const bucket = this.byType.get(type);
+        // Bucket holds only events whose `type === T`, so the cast is sound; route
+        // through `unknown` because TS can't narrow the heterogeneous union here.
+        return (bucket ? [...bucket] : []);
+    }
+    byTurn(turnId) {
+        if (!this.byTurnId)
+            this.buildIndexes();
+        const bucket = this.byTurnId.get(turnId);
+        return bucket ? [...bucket] : [];
+    }
+    toJSON() {
+        return [...this.events];
+    }
+    async append(partial) {
+        const event = materializeEvent(partial, this.base + this.events.length, this.now);
+        this.events.push(event);
+        this.indexEvent(event);
+        // Snapshot listeners so a subscribe/unsubscribe during dispatch (e.g.,
+        // a runTurn finishing and unsubscribing while we're still mid-fanout)
+        // doesn't change the iteration target.
+        const snapshot = [...this.listeners];
+        for (const fn of snapshot) {
+            try {
+                await fn(event);
+            }
+            catch {
+                // Listeners must not block the log; failures are non-fatal here. Hook
+                // failures are recorded as ErrorEvents by the dispatcher above this.
+            }
+        }
+        return event;
+    }
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => this.listeners.delete(fn);
+    }
+    /**
+     * Append an already-materialized event, preserving its `id`/`seq`/`ts`
+     * rather than minting new ones. This is how a thin client mirrors the
+     * runner's log: the server is the sole authority for event identity, so the
+     * mirror must keep the originals. De-dupes by `seq` (idempotent replay) and
+     * fires listeners fire-and-forget - a mirror has no dispatcher to await.
+     *
+     * Not for normal authoring; use {@link append} for that.
+     */
+    ingest(event) {
+        // Contiguous, ordered delivery over a single socket means
+        // seq === base + index. Accept ONLY the next-expected seq: this drops
+        // duplicates (overlap between attach-replay and the live stream,
+        // seq < base + length) AND refuses a gap (seq > base + length) rather than
+        // pushing it at the wrong index, which would permanently desync `seq` from
+        // the array index. A gap can't happen over the reliable in-order
+        // transport, so refusing one is fail-safe.
+        if (event.seq !== this.base + this.events.length)
+            return;
+        this.events.push(event);
+        this.indexEvent(event);
+        const snapshot = [...this.listeners];
+        for (const fn of snapshot) {
+            try {
+                // Fire-and-forget, but attach a rejection handler: an async listener
+                // that rejects must be swallowed the same way append()'s awaited
+                // try/catch swallows it — otherwise it surfaces as an unhandled
+                // rejection and (under Node's default policy) can kill the process.
+                void Promise.resolve(fn(event)).catch(() => {
+                    // Mirror listeners must not break ingestion.
+                });
+            }
+            catch {
+                // Mirror listeners must not break ingestion (synchronous throw).
+            }
+        }
+    }
+    /**
+     * Start this (empty) log at `seq` instead of 0. A mirror primed by a
+     * PARTIAL attach replay (`replay: 'none'` / `{ tail }`) calls this with the
+     * runner's announced first seq so {@link ingest}'s contiguity gate accepts
+     * the stream. Only valid while empty — rebasing held events would detach
+     * their seqs from their indices.
+     */
+    rebase(seq) {
+        if (this.events.length > 0) {
+            throw new Error(`EventLog.rebase(${seq}): log already holds ${this.events.length} events`);
+        }
+        if (!Number.isInteger(seq) || seq < 0) {
+            throw new Error(`EventLog.rebase(${seq}): seq must be a non-negative integer`);
+        }
+        this.base = seq;
+        // Rebase only runs on an empty log, so the indexes (if warm) are already
+        // empty — but null them to stay defensive about the events-array invariant.
+        this.byType = null;
+        this.byTurnId = null;
+    }
+    /**
+     * Drop every event from the log. Used by `/new` to start a fresh
+     * session without rebuilding the entire Session object — the
+     * registries, resolvers, and active provider stay; only the
+     * conversation context vanishes. Per-event listeners are NOT
+     * notified (there's no "event removed" event in the schema), but
+     * {@link onClear} subscribers fire — that's how the persistence
+     * sidecar truncates its JSONL (so `--resume` can't resurrect wiped
+     * history) and how the runner broadcasts a reset to attached
+     * mirrors, in lockstep with the wipe.
+     *
+     * Safe to call only when no turn is in flight — callers should abort
+     * their AbortController and await any pending runTurn() first.
+     */
+    clear() {
+        this.events.length = 0;
+        // The secondary indexes mirror `events`; drop them so the next query
+        // rebuilds from the now-empty array (cheap) rather than serving stale
+        // buckets.
+        this.byType = null;
+        this.byTurnId = null;
+        // A session reset restarts the authoritative stream at seq 0 — a rebased
+        // mirror must follow, or it would wait forever for seqs that never come.
+        this.base = 0;
+        const snapshot = [...this.clearListeners];
+        for (const fn of snapshot) {
+            try {
+                fn();
+            }
+            catch {
+                // A clear listener must not block the wipe.
+            }
+        }
+    }
+    /**
+     * Subscribe to {@link clear}. Fires synchronously after the events array
+     * empties, so a listener reading the log observes the post-wipe state.
+     * Returns the unsubscribe callback.
+     */
+    onClear(fn) {
+        this.clearListeners.add(fn);
+        return () => this.clearListeners.delete(fn);
+    }
+    asReader() {
+        return this;
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/events/log.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+export { Session, type SessionOptions } from './session.js';
+export { runTurn, collectTurn, type RunTurnOptions } from './run-turn.js';
+export { setupAgent, type Agent, type SetupAgentOptions, type AgentPreset, } from './setup-agent.js';
+export type { MoxxyEvent, Plugin, ToolDef, PermissionResolver } from '@moxxy/sdk';
+export { createSubagentSpawner, clearRetainedChildren, type SubagentRuntime } from './subagents.js';
+export { loadPreferences, savePreferences, preferencesPath, type MoxxyPreferences, } from './preferences.js';
+export { loadUsageStats, mergeUsageStats, clearUsageStats, usageStatsPath, type UsageStatsFile, type StoredModelUsage, } from './usage-stats.js';
+export { SkillRegistryImpl } from './registries/skills.js';
+export { parseSkillFile, parseFrontmatter, discoverSkills, defaultUserSkillsDir, defaultProjectSkillsDir, synthesizeSkill, buildSynthesizeSkillPlugin, type SkillLoadOptions, type DiscoveredSkill, type SynthesizeOptions, type SynthesizedSkill, } from './skills/index.js';
+export { EventLog, type EventListener } from './events/log.js';
+export { newTurnId, newSessionId } from './events/factory.js';
+export { ToolRegistryImpl, type ToolRegistry } from './registries/tools.js';
+export { ProviderRegistry } from './registries/providers.js';
+export { ModeRegistry } from './registries/modes.js';
+export { CompactorRegistry } from './registries/compactors.js';
+export { CacheStrategyRegistry } from './registries/cache-strategies.js';
+export { ViewRendererRegistry } from './registries/view-renderers.js';
+export { defaultViewRenderer } from './view/default-renderer.js';
+export { parseView, validateDoc, countNodes } from './view/parse.js';
+export { TunnelProviderRegistry } from './registries/tunnel-providers.js';
+export { localhostTunnel } from './tunnel/localhost.js';
+export { ChannelRegistryImpl } from './registries/channels.js';
+export { AgentRegistry } from './registries/agents.js';
+export { CommandRegistry } from './registries/commands.js';
+export { TranscriberRegistry } from './registries/transcribers.js';
+export { SynthesizerRegistry } from './registries/synthesizers.js';
+export { EmbedderRegistry } from './registries/embedders.js';
+export { IsolatorRegistry as ContributedIsolatorRegistry } from './registries/isolators.js';
+export { RequirementRegistry, type RequirementRegistryOptions } from './requirements.js';
+export { SessionPersistence, defaultSessionsDir, readIndex as readSessionIndex, restoreEvents as restoreSessionEvents, deleteSession, type SessionMeta, type SessionPersistenceOpts, } from './sessions/persistence.js';
+export { PluginHost, PluginRequirementError, type PluginLoader, type PluginSkipReason, type PluginSkipRecord, type PluginSkipSource, type RegisterStaticOptions, } from './plugins/host.js';
+export { HookDispatcherImpl } from './plugins/lifecycle.js';
+export { discoverPlugins } from './plugins/discovery.js';
+export { toposortPluginManifests, PluginCycleError } from './plugins/toposort.js';
+export { readPackageMoxxyRequirements } from './plugins/package-requirements.js';
+export { createPluginLoader, type JitiLoaderOptions } from './plugins/loader.js';
+export { PermissionEngine, permissionPolicySchema, type PermissionPolicy, type PolicyRule, } from './permissions/engine.js';
+export { autoAllowResolver, denyByDefaultResolver, createCallbackResolver, createDeferredPermissionResolver, type DeferredPermissionResolver, type DeferredPermissionResolverOptions, type PermissionPromptHandler, createAllowListResolver, } from './permissions/resolvers.js';
+export { createLogger, silentLogger, type Logger, type LogLevel } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,41 @@
+export { Session } from './session.js';
+export { runTurn, collectTurn } from './run-turn.js';
+export { setupAgent, } from './setup-agent.js';
+export { createSubagentSpawner, clearRetainedChildren } from './subagents.js';
+export { loadPreferences, savePreferences, preferencesPath, } from './preferences.js';
+export { loadUsageStats, mergeUsageStats, clearUsageStats, usageStatsPath, } from './usage-stats.js';
+export { SkillRegistryImpl } from './registries/skills.js';
+export { parseSkillFile, parseFrontmatter, discoverSkills, defaultUserSkillsDir, defaultProjectSkillsDir, synthesizeSkill, buildSynthesizeSkillPlugin, } from './skills/index.js';
+export { EventLog } from './events/log.js';
+// newEventId + materializeEvent are module-private helpers used only by
+// EventLog.append; not re-exported.
+export { newTurnId, newSessionId } from './events/factory.js';
+export { ToolRegistryImpl } from './registries/tools.js';
+export { ProviderRegistry } from './registries/providers.js';
+export { ModeRegistry } from './registries/modes.js';
+export { CompactorRegistry } from './registries/compactors.js';
+export { CacheStrategyRegistry } from './registries/cache-strategies.js';
+export { ViewRendererRegistry } from './registries/view-renderers.js';
+export { defaultViewRenderer } from './view/default-renderer.js';
+export { parseView, validateDoc, countNodes } from './view/parse.js';
+export { TunnelProviderRegistry } from './registries/tunnel-providers.js';
+export { localhostTunnel } from './tunnel/localhost.js';
+export { ChannelRegistryImpl } from './registries/channels.js';
+export { AgentRegistry } from './registries/agents.js';
+export { CommandRegistry } from './registries/commands.js';
+export { TranscriberRegistry } from './registries/transcribers.js';
+export { SynthesizerRegistry } from './registries/synthesizers.js';
+export { EmbedderRegistry } from './registries/embedders.js';
+export { IsolatorRegistry as ContributedIsolatorRegistry } from './registries/isolators.js';
+export { RequirementRegistry } from './requirements.js';
+export { SessionPersistence, defaultSessionsDir, readIndex as readSessionIndex, restoreEvents as restoreSessionEvents, deleteSession, } from './sessions/persistence.js';
+export { PluginHost, PluginRequirementError, } from './plugins/host.js';
+export { HookDispatcherImpl } from './plugins/lifecycle.js';
+export { discoverPlugins } from './plugins/discovery.js';
+export { toposortPluginManifests, PluginCycleError } from './plugins/toposort.js';
+export { readPackageMoxxyRequirements } from './plugins/package-requirements.js';
+export { createPluginLoader } from './plugins/loader.js';
+export { PermissionEngine, permissionPolicySchema, } from './permissions/engine.js';
+export { autoAllowResolver, denyByDefaultResolver, createCallbackResolver, createDeferredPermissionResolver, createAllowListResolver, } from './permissions/resolvers.js';
+export { createLogger, silentLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,16 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+export interface LoggerOptions {
+    minLevel?: LogLevel;
+    sink?: (line: string) => void;
+    bindings?: Record<string, unknown>;
+}
+export declare function createLogger(opts?: LoggerOptions): Logger;
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map