@moxxy/reflector-default 0.27.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/dist/index.d.ts

@@ -0,0 +1,94 @@
+import { type MoxxyEvent, type Plugin, type ReflectionProposal, type ReflectorDef, type SessionId } from '@moxxy/sdk';
+/**
+ * @moxxy/reflector-default — the default learning-loop block.
+ *
+ * TWO parts ship in one plugin:
+ *   1. a {@link ReflectorDef} named `'default'` (the strategy): one cheap
+ *      side-channel LLM pass over a finished turn that returns 0-2
+ *      {@link ReflectionProposal}s;
+ *   2. the DRIVER (lifecycle hooks): decides WHEN to reflect (a cheap gate +
+ *      a one-per-session budget), runs the active reflector fire-and-forget on
+ *      `onTurnEnd`, and delivers any proposals as a ONE-TIME nudge on the next
+ *      `onBeforeProviderCall`.
+ *
+ * The load-bearing property is "propose, don't write": a proposal never mutates
+ * memory or skills. It is injected into the next request's system prompt phrased
+ * so the MODEL may call `memory_save` / `synthesize_skill` — which still hit
+ * their own permission prompts. The reflection itself is best-effort: it runs
+ * detached from the turn, catches everything, and skips silently when there is
+ * no provider or the provider errors.
+ */
+/** Reflect when a turn did at least this many tool calls (busy/procedural turn). */
+export declare const REFLECT_MIN_TOOL_RESULTS = 5;
+/** Reflect when a turn ran at least this many mode-loop rounds (a hard task). */
+export declare const REFLECT_MIN_ITERATIONS = 8;
+/** Upper bound on the whole reflection (side-channel LLM pass). */
+export declare const REFLECT_TIMEOUT_MS = 30000;
+export declare const REFLECT_SYSTEM_PROMPT = "You review a single finished agent turn and decide whether anything is worth remembering for the future.\n\nLook for exactly two things:\n- a durable FACT worth saving to long-term memory (a stable preference, a project detail, a hard-won answer) \u2192 kind \"memory\"\n- a repeated multi-step PROCEDURE worth capturing as a reusable skill \u2192 kind \"skill\"\n\nBe strict. Most turns warrant NOTHING. Never propose transient chit-chat, one-off values, or things already obvious from context.\n\nOutput ONLY a JSON array with 0, 1, or 2 items \u2014 no prose, no code fences. Each item:\n  { \"kind\": \"memory\" | \"skill\", \"title\": \"<= 80 chars\", \"nudge\": \"one paragraph addressed to the assistant, suggesting it consider saving this\" }\nReturn [] when nothing is worth proposing.";
+/**
+ * The cheap gate, run synchronously on `onTurnEnd` against the turn's events.
+ * A turn is worth reflecting on when it was busy (≥{@link REFLECT_MIN_TOOL_RESULTS}
+ * tool results), hit an error, or ground through ≥{@link REFLECT_MIN_ITERATIONS}
+ * mode-loop rounds. A quiet turn (a quick Q&A) is skipped.
+ */
+export declare function shouldReflect(events: ReadonlyArray<MoxxyEvent>): boolean;
+/**
+ * Build a compact text digest of a turn from its events: the user prompt, the
+ * tool names invoked (with counts), any error snippets, and the final assistant
+ * text — each snippet clipped, the whole thing capped at {@link MAX_DIGEST_CHARS}.
+ * This is what the reflection model reads instead of the raw event stream.
+ */
+export declare function buildTurnDigest(events: ReadonlyArray<MoxxyEvent>): string;
+/**
+ * Defensively parse the reflection model's reply into 0-2 proposals. Strips an
+ * optional ```json fence, takes the first `[` … last `]` span, refuses an
+ * oversized span, JSON-parses, validates each item, and clamps to 2. ANY
+ * failure (no array, malformed JSON, wrong shape) yields `[]` — a bad reply
+ * silently produces no nudge rather than throwing into the detached reflection.
+ */
+export declare function parseReflectionReply(text: string): ReflectionProposal[];
+/**
+ * The one-time nudge injected into the next provider request's system prompt.
+ * Phrased as a suggestion the model MAY act on via `memory_save` /
+ * `synthesize_skill` (each of which asks the user for permission) — never a
+ * directive, never a silent write.
+ */
+export declare function buildNudgeBlock(proposals: ReadonlyArray<ReflectionProposal>): string;
+/**
+ * The default reflector: one cheap side-channel LLM pass over the finished
+ * turn. Resolves the active provider from the service registry, streams a
+ * strict-JSON reply, and parses it into 0-2 proposals. Returns `[]` (never
+ * throws) when there is no active provider or the provider errors — reflection
+ * degrades to a no-op rather than surfacing anything into the session.
+ */
+export declare const reflectorDefaultDef: ReflectorDef;
+/** Per-session reflection budget: window = the whole session for v1. */
+export interface SessionBudget {
+    /** Reflections fired this window (v1 cap = 1). */
+    readonly count: number;
+    /** Seq of the last turn's last event reflected on (future windowing aid). */
+    readonly lastSeq: number;
+}
+/** Test-facing handle into the driver's private per-session state. */
+export interface ReflectorInternals {
+    /** Await the (fire-and-forget) reflection kicked off for a session, if any. */
+    settle(sessionId: SessionId): Promise<void>;
+    /** The pending one-time nudge for a session, or null. */
+    pendingNudge(sessionId: SessionId): string | null;
+    /** The session's reflection budget, or undefined when it never fired the gate. */
+    budget(sessionId: SessionId): SessionBudget | undefined;
+}
+export interface BuildReflectorPluginResult {
+    readonly plugin: Plugin;
+    readonly internals: ReflectorInternals;
+}
+/**
+ * Build the reflector plugin. The default export calls this with no options;
+ * tests use the returned `internals` handle to await the detached reflection
+ * and inspect the budget / pending nudge deterministically.
+ */
+export declare function buildReflectorPlugin(): BuildReflectorPluginResult;
+/** Discovery-loadable default export (the plain plugin, no test handle). */
+declare const reflectorPlugin: Plugin;
+export default reflectorPlugin;
+//# 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":"AAAA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,MAAM,EAGX,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AAGH,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAUzC,eAAO,MAAM,qBAAqB,+xBAUS,CAAC;AAI5C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAYxE;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,MAAM,CAyCzE;AASD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAevE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAQpF;AAyDD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAgCjC,CAAC;AAIF,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAOD,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yDAAyD;IACzD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,kFAAkF;IAClF,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,0BAA0B,CA2GjE;AAED,4EAA4E;AAC5E,QAAA,MAAM,eAAe,EAAE,MAAsC,CAAC;AAC9D,eAAe,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,368 @@
+import { definePlugin, z, } from '@moxxy/sdk';
+/**
+ * @moxxy/reflector-default — the default learning-loop block.
+ *
+ * TWO parts ship in one plugin:
+ *   1. a {@link ReflectorDef} named `'default'` (the strategy): one cheap
+ *      side-channel LLM pass over a finished turn that returns 0-2
+ *      {@link ReflectionProposal}s;
+ *   2. the DRIVER (lifecycle hooks): decides WHEN to reflect (a cheap gate +
+ *      a one-per-session budget), runs the active reflector fire-and-forget on
+ *      `onTurnEnd`, and delivers any proposals as a ONE-TIME nudge on the next
+ *      `onBeforeProviderCall`.
+ *
+ * The load-bearing property is "propose, don't write": a proposal never mutates
+ * memory or skills. It is injected into the next request's system prompt phrased
+ * so the MODEL may call `memory_save` / `synthesize_skill` — which still hit
+ * their own permission prompts. The reflection itself is best-effort: it runs
+ * detached from the turn, catches everything, and skips silently when there is
+ * no provider or the provider errors.
+ */
+// ── Gate thresholds ─────────────────────────────────────────────────────────
+/** Reflect when a turn did at least this many tool calls (busy/procedural turn). */
+export const REFLECT_MIN_TOOL_RESULTS = 5;
+/** Reflect when a turn ran at least this many mode-loop rounds (a hard task). */
+export const REFLECT_MIN_ITERATIONS = 8;
+/** Upper bound on the whole reflection (side-channel LLM pass). */
+export const REFLECT_TIMEOUT_MS = 30_000;
+/** Cap on the model reply span we'll JSON-parse — past this is malformed/hostile. */
+const MAX_JSON_SPAN = 32 * 1024;
+/** Cap on the turn digest handed to the reflection model. */
+const MAX_DIGEST_CHARS = 4000;
+/** Cap on a single snippet (prompt / assistant text / one error) inside the digest. */
+const MAX_SNIPPET_CHARS = 600;
+/** Tokens for the reflection pass — proposals are tiny. */
+const REFLECT_MAX_TOKENS = 1200;
+export const REFLECT_SYSTEM_PROMPT = `You review a single finished agent turn and decide whether anything is worth remembering for the future.
+
+Look for exactly two things:
+- a durable FACT worth saving to long-term memory (a stable preference, a project detail, a hard-won answer) → kind "memory"
+- a repeated multi-step PROCEDURE worth capturing as a reusable skill → kind "skill"
+
+Be strict. Most turns warrant NOTHING. Never propose transient chit-chat, one-off values, or things already obvious from context.
+
+Output ONLY a JSON array with 0, 1, or 2 items — no prose, no code fences. Each item:
+  { "kind": "memory" | "skill", "title": "<= 80 chars", "nudge": "one paragraph addressed to the assistant, suggesting it consider saving this" }
+Return [] when nothing is worth proposing.`;
+// ── Pure helpers (exported for tests) ───────────────────────────────────────
+/**
+ * The cheap gate, run synchronously on `onTurnEnd` against the turn's events.
+ * A turn is worth reflecting on when it was busy (≥{@link REFLECT_MIN_TOOL_RESULTS}
+ * tool results), hit an error, or ground through ≥{@link REFLECT_MIN_ITERATIONS}
+ * mode-loop rounds. A quiet turn (a quick Q&A) is skipped.
+ */
+export function shouldReflect(events) {
+    let toolResults = 0;
+    let errors = 0;
+    let iterations = 0;
+    for (const e of events) {
+        if (e.type === 'tool_result')
+            toolResults++;
+        else if (e.type === 'error')
+            errors++;
+        else if (e.type === 'mode_iteration')
+            iterations++;
+    }
+    return (toolResults >= REFLECT_MIN_TOOL_RESULTS || errors >= 1 || iterations >= REFLECT_MIN_ITERATIONS);
+}
+function clip(text, max) {
+    const t = text.trim();
+    return t.length > max ? t.slice(0, max) + '…' : t;
+}
+/**
+ * Build a compact text digest of a turn from its events: the user prompt, the
+ * tool names invoked (with counts), any error snippets, and the final assistant
+ * text — each snippet clipped, the whole thing capped at {@link MAX_DIGEST_CHARS}.
+ * This is what the reflection model reads instead of the raw event stream.
+ */
+export function buildTurnDigest(events) {
+    const parts = [];
+    const prompt = events.find((e) => e.type === 'user_prompt');
+    if (prompt && prompt.type === 'user_prompt') {
+        parts.push(`USER: ${clip(prompt.text, MAX_SNIPPET_CHARS)}`);
+    }
+    const toolCounts = new Map();
+    for (const e of events) {
+        if (e.type === 'tool_call_requested') {
+            toolCounts.set(e.name, (toolCounts.get(e.name) ?? 0) + 1);
+        }
+    }
+    if (toolCounts.size > 0) {
+        const list = [...toolCounts.entries()]
+            .map(([name, n]) => (n > 1 ? `${name}×${n}` : name))
+            .join(', ');
+        parts.push(`TOOLS: ${list}`);
+    }
+    const errorSnippets = [];
+    for (const e of events) {
+        if (e.type === 'tool_result' && e.ok === false && e.error?.message) {
+            errorSnippets.push(clip(e.error.message, 200));
+        }
+        else if (e.type === 'error') {
+            errorSnippets.push(clip(e.message, 200));
+        }
+    }
+    if (errorSnippets.length > 0) {
+        parts.push(`ERRORS: ${errorSnippets.slice(0, 5).join(' | ')}`);
+    }
+    // Last finalized assistant message is the turn's conclusion.
+    let finalText = null;
+    for (const e of events) {
+        if (e.type === 'assistant_message' && e.content.trim())
+            finalText = e.content;
+    }
+    if (finalText)
+        parts.push(`ASSISTANT: ${clip(finalText, MAX_SNIPPET_CHARS)}`);
+    return clip(parts.join('\n'), MAX_DIGEST_CHARS);
+}
+const proposalSchema = z.object({
+    kind: z.enum(['memory', 'skill']),
+    title: z.string().min(1).max(200),
+    nudge: z.string().min(1).max(2000),
+});
+const proposalsSchema = z.array(proposalSchema);
+/**
+ * Defensively parse the reflection model's reply into 0-2 proposals. Strips an
+ * optional ```json fence, takes the first `[` … last `]` span, refuses an
+ * oversized span, JSON-parses, validates each item, and clamps to 2. ANY
+ * failure (no array, malformed JSON, wrong shape) yields `[]` — a bad reply
+ * silently produces no nudge rather than throwing into the detached reflection.
+ */
+export function parseReflectionReply(text) {
+    try {
+        const fenced = /```(?:json)?\n?([\s\S]*?)```/.exec(text);
+        const candidate = fenced ? fenced[1] : text;
+        const start = candidate.indexOf('[');
+        const end = candidate.lastIndexOf(']');
+        if (start === -1 || end <= start)
+            return [];
+        const span = candidate.slice(start, end + 1);
+        if (span.length > MAX_JSON_SPAN)
+            return [];
+        const parsed = proposalsSchema.safeParse(JSON.parse(span));
+        if (!parsed.success)
+            return [];
+        return parsed.data.slice(0, 2).map((p) => ({ kind: p.kind, title: p.title, nudge: p.nudge }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The one-time nudge injected into the next provider request's system prompt.
+ * Phrased as a suggestion the model MAY act on via `memory_save` /
+ * `synthesize_skill` (each of which asks the user for permission) — never a
+ * directive, never a silent write.
+ */
+export function buildNudgeBlock(proposals) {
+    const lines = proposals.map((p) => `- (${p.kind}) ${p.title}: ${p.nudge}`).join('\n');
+    return (`\n\n[reflection] A background review of the last turn surfaced ${proposals.length} ` +
+        `suggestion(s) you MAY act on if genuinely useful (otherwise ignore):\n${lines}\n` +
+        'To persist one, you may call `memory_save` (a durable fact) or `synthesize_skill` ' +
+        '(a repeatable procedure) — each asks the user for permission first. Do not act unless it clearly helps.');
+}
+/** Collect a provider stream into text, honoring the abort signal. */
+async function streamText(provider, req) {
+    let out = '';
+    const iterable = provider.stream(req);
+    const iterator = iterable[Symbol.asyncIterator]();
+    try {
+        for (;;) {
+            if (req.signal?.aborted)
+                break;
+            const step = await raceAbort(iterator.next(), req.signal);
+            if (step === ABORTED)
+                break;
+            if (step.done)
+                break;
+            const event = step.value;
+            if (event.type === 'text_delta')
+                out += event.delta;
+            else if (event.type === 'error')
+                throw new Error(event.message);
+        }
+    }
+    finally {
+        if (req.signal?.aborted)
+            void iterator.return?.(undefined).catch(() => { });
+    }
+    return out;
+}
+const ABORTED = Symbol('aborted');
+function raceAbort(step, signal) {
+    if (!signal)
+        return step;
+    if (signal.aborted) {
+        void step.catch(() => { });
+        return Promise.resolve(ABORTED);
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            void step.catch(() => { });
+            resolve(ABORTED);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        step.then((v) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(v);
+        }, (e) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(e);
+        });
+    });
+}
+/**
+ * The default reflector: one cheap side-channel LLM pass over the finished
+ * turn. Resolves the active provider from the service registry, streams a
+ * strict-JSON reply, and parses it into 0-2 proposals. Returns `[]` (never
+ * throws) when there is no active provider or the provider errors — reflection
+ * degrades to a no-op rather than surfacing anything into the session.
+ */
+export const reflectorDefaultDef = {
+    name: 'default',
+    displayName: 'Default learning loop',
+    async reflect(ctx) {
+        const providers = ctx.services.get('providers');
+        // Graceful no-provider skip: nothing to reflect with.
+        if (!providers || providers.getActiveName() == null)
+            return [];
+        let provider;
+        try {
+            provider = providers.getActive();
+        }
+        catch {
+            return [];
+        }
+        const digest = buildTurnDigest(ctx.log.byTurn(ctx.turnId));
+        if (!digest)
+            return [];
+        const req = {
+            model: provider.models[0]?.id ?? 'unknown',
+            system: REFLECT_SYSTEM_PROMPT,
+            messages: [{ role: 'user', content: [{ type: 'text', text: digest }] }],
+            maxTokens: REFLECT_MAX_TOKENS,
+            signal: ctx.signal,
+        };
+        try {
+            const reply = await streamText(provider, req);
+            return parseReflectionReply(reply);
+        }
+        catch {
+            // Provider error / abort → degrade to a no-op rather than surfacing.
+            return [];
+        }
+    },
+};
+/**
+ * Build the reflector plugin. The default export calls this with no options;
+ * tests use the returned `internals` handle to await the detached reflection
+ * and inspect the budget / pending nudge deterministically.
+ */
+export function buildReflectorPlugin() {
+    // All keyed by sessionId so one shared instance stays correct across the many
+    // sessions a runner hosts in one process; every map self-cleans in onShutdown.
+    const budgets = new Map();
+    const pending = new Map();
+    const inFlight = new Map();
+    const shutdownControllers = new Map();
+    function cleanup(sessionId) {
+        try {
+            shutdownControllers.get(sessionId)?.abort();
+        }
+        catch {
+            // aborting a controller never throws in practice; guard anyway.
+        }
+        shutdownControllers.delete(sessionId);
+        budgets.delete(sessionId);
+        pending.delete(sessionId);
+        inFlight.delete(sessionId);
+    }
+    const hooks = {
+        // AWAITED by the lifecycle dispatcher (with a per-plugin timeout), so this
+        // MUST return fast: the gate + budget check are synchronous, and the actual
+        // reflection is kicked off FIRE-AND-FORGET (a guarded detached promise) so
+        // it never blocks the turn and can never throw into it.
+        onTurnEnd(ctx) {
+            try {
+                const events = ctx.log.byTurn(ctx.turnId);
+                if (!shouldReflect(events))
+                    return;
+                const prior = budgets.get(ctx.sessionId) ?? { count: 0, lastSeq: -1 };
+                // Budget: at most one reflection per session window (v1 = whole session).
+                if (prior.count >= 1)
+                    return;
+                const reflectors = ctx.services.get('reflectors');
+                const reflector = reflectors?.getActive() ?? null;
+                // Nullable registry: no active reflector → reflection is off. Do NOT
+                // consume the budget (so activating one later still gets a chance).
+                if (!reflector)
+                    return;
+                // Reserve the budget slot BEFORE going async so a rapid next turn can't
+                // double-fire while this reflection is still in flight.
+                const lastSeq = events.length > 0 ? events[events.length - 1].seq : prior.lastSeq;
+                budgets.set(ctx.sessionId, { count: prior.count + 1, lastSeq });
+                let sc = shutdownControllers.get(ctx.sessionId);
+                if (!sc) {
+                    sc = new AbortController();
+                    shutdownControllers.set(ctx.sessionId, sc);
+                }
+                const signal = AbortSignal.any([sc.signal, AbortSignal.timeout(REFLECT_TIMEOUT_MS)]);
+                const reflectCtx = {
+                    sessionId: ctx.sessionId,
+                    turnId: ctx.turnId,
+                    cwd: ctx.cwd,
+                    log: ctx.log,
+                    services: ctx.services,
+                    signal,
+                };
+                const p = (async () => {
+                    try {
+                        const proposals = await reflector.reflect(reflectCtx);
+                        if (proposals.length > 0)
+                            pending.set(ctx.sessionId, buildNudgeBlock(proposals));
+                    }
+                    catch {
+                        // Best-effort: a no-provider skip, provider error, or reflector
+                        // throw must never surface. The budget stays spent (one attempt).
+                    }
+                })();
+                inFlight.set(ctx.sessionId, p);
+                // Detach: do NOT return `p` — onTurnEnd resolves immediately.
+                void p;
+            }
+            catch {
+                // The gate itself (a hostile log reader, etc.) must never take down the
+                // awaited onTurnEnd hook.
+            }
+        },
+        // Deliver a pending reflection as a ONE-TIME nudge on the next provider call.
+        onBeforeProviderCall(req, ctx) {
+            const nudge = pending.get(ctx.sessionId);
+            if (!nudge)
+                return;
+            pending.delete(ctx.sessionId); // one-shot: cleared after injection
+            return { ...req, system: (req.system ?? '') + nudge };
+        },
+        onShutdown(ctx) {
+            cleanup(ctx.sessionId);
+        },
+    };
+    const plugin = definePlugin({
+        name: '@moxxy/reflector-default',
+        version: '0.0.0',
+        reflectors: [reflectorDefaultDef],
+        hooks,
+    });
+    const internals = {
+        async settle(sessionId) {
+            await inFlight.get(sessionId)?.catch(() => { });
+        },
+        pendingNudge: (sessionId) => pending.get(sessionId) ?? null,
+        budget: (sessionId) => budgets.get(sessionId),
+    };
+    return { plugin, internals };
+}
+/** Discovery-loadable default export (the plain plugin, no test handle). */
+const reflectorPlugin = buildReflectorPlugin().plugin;
+export default reflectorPlugin;
+//# 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/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@moxxy/reflector-default",
+  "version": "0.27.0",
+  "description": "The default learning-loop reflector: watches finished turns and proposes memory/skill improvements as a one-time nudge on the next provider call — never a silent write. The model may act via memory_save/synthesize_skill, which still hit their own permission prompts.",
+  "keywords": [
+    "moxxy",
+    "agent",
+    "reflector",
+    "learning-loop",
+    "memory"
+  ],
+  "homepage": "https://moxxy.ai",
+  "bugs": {
+    "url": "https://github.com/moxxy-ai/moxxy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moxxy-ai/moxxy.git",
+    "directory": "packages/reflector-default"
+  },
+  "author": "Michal Makowski <michal.makowski97@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "moxxy": {
+    "plugin": {
+      "entry": "./dist/index.js",
+      "kind": "reflector"
+    },
+    "requirements": [
+      {
+        "kind": "tool",
+        "name": "memory_save",
+        "state": "active",
+        "optional": true,
+        "hint": "Install @moxxy/plugin-memory so the model can act on memory proposals."
+      },
+      {
+        "kind": "tool",
+        "name": "synthesize_skill",
+        "state": "active",
+        "optional": true,
+        "hint": "synthesize_skill (bundled with the CLI) lets the model act on skill proposals."
+      }
+    ]
+  },
+  "dependencies": {
+    "zod": "^3.24.0",
+    "@moxxy/sdk": "0.27.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8",
+    "@moxxy/testing": "0.0.45",
+    "@moxxy/vitest-preset": "0.0.0",
+    "@moxxy/tsconfig": "0.0.0",
+    "@moxxy/core": "0.27.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}