@moxxy/sdk 0.14.2 → 0.14.3

package/dist/mode/collect-stream.d.ts

@@ -0,0 +1,68 @@
+import type { ProviderMessage, TokenUsage } from '../provider.js';
+import type { ModeContext } from '../mode.js';
+import type { StopReason } from '../provider-utils.js';
+/**
+ * Shared bits used by every loop strategy: a typed tool-use struct and a
+ * common stream-collection helper that runs `onBeforeProviderCall` hooks
+ * and reduces a provider stream down to `{text, toolUses, stopReason}`.
+ *
+ * Lives in core (not in each loop package) so a new loop strategy stays
+ * consistent — and so behavioral fixes here propagate. Previously
+ * loop-plan-execute had its own copy that skipped the hook (audit bug).
+ */
+export interface CollectedToolUse {
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface StreamResult {
+    readonly text: string;
+    readonly toolUses: ReadonlyArray<CollectedToolUse>;
+    readonly stopReason: StopReason;
+    readonly error: {
+        readonly message: string;
+        readonly retryable: boolean;
+    } | null;
+    /** Token usage reported by the provider on `message_end`, including cache hits/writes. */
+    readonly usage?: TokenUsage;
+    /**
+     * Reasoning/thinking summary for this provider call, when the model emitted
+     * any. The mode emits it as a `reasoning_message` event (so it persists and
+     * round-trips). `signature`/`encrypted` carry Anthropic's signed thinking
+     * block / redacted blob; `redacted` marks display-suppressed reasoning.
+     */
+    readonly reasoning?: {
+        readonly text: string;
+        readonly signature?: string;
+        readonly redacted?: boolean;
+        readonly encrypted?: string;
+    };
+}
+/**
+ * Pulls a provider stream, emits `assistant_chunk` events for text deltas,
+ * collects tool_use blocks, and returns the final `{text, toolUses, stopReason}`.
+ * Runs `onBeforeProviderCall` lifecycle hooks before the call.
+ */
+export declare function collectProviderStream(ctx: ModeContext, messages: ReadonlyArray<ProviderMessage>, opts?: {
+    iteration?: number;
+    includeTools?: boolean;
+    maxTokens?: number;
+    /**
+     * Index (into `messages`) of the last stable-prefix message, from
+     * {@link projectMessages}. Passed to the active cache strategy as
+     * `stablePrefixMessageIndex` so it can place a long-lived cross-turn
+     * breakpoint at the elision boundary. Omit (or -1) when unknown — the
+     * strategy then falls back to its tools/system/tail breakpoints only.
+     */
+    stablePrefixIndex?: number;
+    /**
+     * Number of trailing messages in `messages` that are volatile — injected
+     * for this call only (e.g. goal mode's `trailingUserText` nudge) and
+     * absent from the append-only log, so they won't recur at the same
+     * position next call. Forwarded to the cache strategy as
+     * `volatileTailMessageCount` so it keeps its rolling tail breakpoint
+     * before them instead of paying a guaranteed-wasted cache write.
+     */
+    volatileTailCount?: number;
+}): Promise<StreamResult>;
+//# sourceMappingURL=collect-stream.d.ts.map

package/dist/mode/collect-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-stream.d.ts","sourceRoot":"","sources":["../../src/mode/collect-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjF,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,aAAa,CAAC,eAAe,CAAC,EACxC,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACvB,GACL,OAAO,CAAC,YAAY,CAAC,CA8KvB"}

package/dist/mode/collect-stream.js

@@ -0,0 +1,181 @@
+import { applyLazyTools } from '../tool-gating.js';
+/**
+ * Pulls a provider stream, emits `assistant_chunk` events for text deltas,
+ * collects tool_use blocks, and returns the final `{text, toolUses, stopReason}`.
+ * Runs `onBeforeProviderCall` lifecycle hooks before the call.
+ */
+export async function collectProviderStream(ctx, messages, opts = {}) {
+    // Lazy tool gating (opt-in): send only always-on + loaded tool schemas, and
+    // index the rest in the system prompt. Runs BEFORE cache planning since it
+    // rewrites the system message and the tool list.
+    let effectiveMessages = messages;
+    let toolList = opts.includeTools === false ? undefined : ctx.tools.list();
+    if (ctx.lazyTools && toolList) {
+        const gated = applyLazyTools(messages, toolList, ctx.log);
+        effectiveMessages = gated.messages;
+        toolList = gated.tools;
+    }
+    // Ask the active cache strategy where to place prompt-cache breakpoints.
+    // The strategy is provider-neutral (returns CacheHints); the provider
+    // translates them (Anthropic → cache_control). Falls back to no hints when
+    // no strategy is registered. The onBeforeProviderCall hook can still adjust.
+    const descriptor = ctx.provider.models.find((m) => m.id === ctx.model);
+    const cacheHints = ctx.cacheStrategy
+        ? ctx.cacheStrategy.plan(effectiveMessages, {
+            model: ctx.model,
+            contextWindow: descriptor?.contextWindow ?? 0,
+            log: ctx.log,
+            ...(opts.stablePrefixIndex != null && opts.stablePrefixIndex >= 0
+                ? { stablePrefixMessageIndex: opts.stablePrefixIndex }
+                : {}),
+            ...(opts.volatileTailCount != null && opts.volatileTailCount > 0
+                ? { volatileTailMessageCount: opts.volatileTailCount }
+                : {}),
+        })
+        : undefined;
+    // NOTE: `system` is deliberately NOT prefilled with ctx.systemPrompt — the
+    // composed system prompt already rides as the leading system-role message
+    // (see projectMessages), and providers deliver `req.system` IN ADDITION to
+    // message-derived system text. Prefilling it would duplicate the prompt.
+    // It stays as the side channel `onBeforeProviderCall` hooks use to inject
+    // per-request system text (e.g. the memory consolidation nudge).
+    // Forward the per-provider reasoning preference, but only when THIS model
+    // advertises `supportsReasoning` — providers ignore the knob otherwise, but
+    // gating here keeps requests clean and avoids unsupported-param errors.
+    const reqReasoning = descriptor?.supportsReasoning ? ctx.reasoning : undefined;
+    const req = {
+        model: ctx.model,
+        messages: effectiveMessages,
+        ...(toolList ? { tools: toolList } : {}),
+        ...(cacheHints && cacheHints.length > 0 ? { cacheHints } : {}),
+        ...(opts.maxTokens !== undefined ? { maxTokens: opts.maxTokens } : {}),
+        ...(reqReasoning ? { reasoning: reqReasoning } : {}),
+        signal: ctx.signal,
+    };
+    const transformed = await ctx.hooks.dispatchBeforeProviderCall(req, {
+        sessionId: ctx.sessionId,
+        cwd: '',
+        log: ctx.log,
+        env: {},
+        turnId: ctx.turnId,
+        iteration: opts.iteration ?? 0,
+    });
+    let text = '';
+    const toolUses = new Map();
+    let stopReason = 'end_turn';
+    let error = null;
+    let usage;
+    // Reasoning/thinking accumulation for this single provider call. Emitted as a
+    // finalized `reasoning_message` by the mode (turn-iterator / goal-loop) so it
+    // persists and round-trips; `signature`/`encrypted` carry Anthropic's signed
+    // thinking block / redacted blob for replay.
+    let reasoningText = '';
+    let reasoningSignature;
+    let reasoningRedacted = false;
+    let reasoningEncrypted;
+    let stream;
+    try {
+        stream = ctx.provider.stream(transformed);
+    }
+    catch (err) {
+        return {
+            text: '',
+            toolUses: [],
+            stopReason: 'error',
+            error: { message: err instanceof Error ? err.message : String(err), retryable: false },
+        };
+    }
+    try {
+        for await (const event of stream) {
+            switch (event.type) {
+                case 'text_delta': {
+                    text += event.delta;
+                    await ctx.emit({
+                        type: 'assistant_chunk',
+                        sessionId: ctx.sessionId,
+                        turnId: ctx.turnId,
+                        source: 'model',
+                        delta: event.delta,
+                    });
+                    break;
+                }
+                case 'tool_use_start': {
+                    toolUses.set(event.id, { name: event.name });
+                    break;
+                }
+                case 'tool_use_end': {
+                    const existing = toolUses.get(event.id) ?? {};
+                    toolUses.set(event.id, { ...existing, input: event.input });
+                    break;
+                }
+                case 'message_end': {
+                    stopReason = event.stopReason;
+                    if (event.usage)
+                        usage = event.usage;
+                    break;
+                }
+                case 'error': {
+                    error = { message: event.message, retryable: event.retryable };
+                    break;
+                }
+                case 'reasoning_delta': {
+                    reasoningText += event.delta;
+                    // Live preview only — parallels `assistant_chunk`; renderers
+                    // accumulate ephemerally and clear on the finalized reasoning_message.
+                    await ctx.emit({
+                        type: 'reasoning_chunk',
+                        sessionId: ctx.sessionId,
+                        turnId: ctx.turnId,
+                        source: 'model',
+                        delta: event.delta,
+                    });
+                    break;
+                }
+                case 'reasoning_signature': {
+                    if (event.signature)
+                        reasoningSignature = event.signature;
+                    if (event.encrypted)
+                        reasoningEncrypted = event.encrypted;
+                    if (event.redacted)
+                        reasoningRedacted = true;
+                    break;
+                }
+                case 'message_start':
+                case 'tool_use_delta':
+                default:
+                    break;
+            }
+        }
+    }
+    catch (err) {
+        error = {
+            message: err instanceof Error ? err.message : String(err),
+            retryable: false,
+        };
+    }
+    const finalToolUses = [];
+    for (const [id, partial] of toolUses) {
+        if (!partial.name)
+            continue;
+        finalToolUses.push({ id, name: partial.name, input: partial.input ?? {} });
+    }
+    // Surface reasoning when there's visible text OR an opaque blob to replay
+    // (a redacted_thinking block has no text but must still round-trip).
+    const reasoning = reasoningText.trim().length > 0 || reasoningEncrypted
+        ? {
+            text: reasoningText,
+            ...(reasoningSignature ? { signature: reasoningSignature } : {}),
+            ...(reasoningRedacted ? { redacted: true } : {}),
+            ...(reasoningEncrypted ? { encrypted: reasoningEncrypted } : {}),
+        }
+        : undefined;
+    return {
+        text,
+        toolUses: finalToolUses,
+        stopReason,
+        error,
+        ...(usage ? { usage } : {}),
+        ...(reasoning ? { reasoning } : {}),
+    };
+}
+//# sourceMappingURL=collect-stream.js.map

package/dist/mode/collect-stream.js.map

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

package/dist/mode/project-messages.d.ts

@@ -0,0 +1,84 @@
+import type { ContentBlock, ProviderMessage } from '../provider.js';
+import type { ModeContext } from '../mode.js';
+import type { Skill } from '../skill.js';
+import type { MoxxyEvent, UserPromptEvent } from '../events.js';
+import { type ElisionState } from '../elision-state.js';
+/** Appended to the system prompt while elision is active (see projection). */
+export declare const ELISION_SYSTEM_NOTE: string;
+/**
+ * Compose a model-facing system prompt that includes any base prompt
+ * plus a COMPACT skill index (name + description + triggers only).
+ *
+ * Lazy-loading design: the body is intentionally NOT inlined. The model
+ * matches user intent against the description/triggers, then calls the
+ * `load_skill` tool to fetch the body of the skill it picked. This keeps
+ * the system prompt small even with many skills installed and avoids
+ * paying for skill bodies the model never actually follows.
+ */
+export declare function buildSystemPromptWithSkills(baseSystemPrompt: string | undefined, skills: ReadonlyArray<Skill>): string | undefined;
+export interface ProjectMessagesOptions {
+    /** Optional system prompt; emitted as the first message when set. */
+    readonly systemPrompt?: string;
+    /** Optional trailing user message — useful for plan-execute's "Focus on this step now: X". */
+    readonly trailingUserText?: string;
+}
+/**
+ * Pure projection of a single `user_prompt` event to its content blocks.
+ *
+ * Extracted from {@link projectMessages} as an independently testable sub-step
+ * (u123-5). Returns either the collapsed stub (when the event is an elided
+ * conversational turn) or the full text + attachment-expanded blocks — exactly
+ * what the inline switch arm produced. Caller decides how to wrap it as a
+ * message / record the stable prefix.
+ */
+export declare function projectUserPrompt(event: UserPromptEvent, el: ElisionState): ContentBlock[];
+/**
+ * Precompute the set of callIds that have a matching tool_result (or
+ * tool_call_denied) somewhere in the log. Used to synthesize a fallback
+ * `[interrupted]` tool_result for orphan tool_use blocks when the assistant
+ * message gets flushed.
+ *
+ * Without this fallback the provider rejects the whole conversation with
+ * "assistant message with 'tool_calls' must be followed by tool messages
+ * responding to each 'tool_call_id'". Orphans typically appear after a
+ * cancelled turn, an aborted process, or a tool exception that bypassed the
+ * loop's tool_result emit path.
+ *
+ * Extracted as a pure precompute (u123-5); returns a fresh mutable Set the
+ * projection augments as it synthesizes orphan results (so a repeated orphan
+ * across groups is only emitted once).
+ */
+export declare function resolvedCallIdSet(events: ReadonlyArray<MoxxyEvent>): Set<string>;
+/**
+ * Project the session's event log to a flat list of ProviderMessages
+ * suitable for handing to `provider.stream`. Used by every loop strategy.
+ *
+ * Handles user_prompt, assistant_message, tool_call_requested (grouped
+ * into a single assistant message of tool_use blocks), and tool_result.
+ * Other event types are passed through as a no-op.
+ *
+ * This is THE projection every loop strategy uses; it honors compaction
+ * events, turn-boundary elision, and the orphan-tool_use fallback. It lives in
+ * the SDK so loop plugins stay independent of core.
+ */
+export interface ProjectedMessages {
+    readonly messages: ProviderMessage[];
+    /**
+     * Index (into `messages`) of the last message belonging to the stable,
+     * byte-identical prefix — i.e. produced entirely from events at or below the
+     * elision high-water mark (which only advances on whole-turn boundaries, so
+     * the cut never splits a message). -1 when no elision is active. The
+     * `stable-prefix` cache strategy places its long-lived cross-turn breakpoint
+     * here; see {@link collectProviderStream}'s `stablePrefixIndex` option.
+     */
+    readonly stablePrefixIndex: number;
+}
+export declare function projectMessagesFromLog(ctx: Pick<ModeContext, 'log'>, opts?: ProjectMessagesOptions): ProviderMessage[];
+/**
+ * Same projection as {@link projectMessagesFromLog} but also reports the
+ * stable-prefix boundary so the active cache strategy can place a cross-turn
+ * breakpoint. Modes that build messages this way should thread the returned
+ * `stablePrefixIndex` into {@link collectProviderStream}.
+ */
+export declare function projectMessages(ctx: Pick<ModeContext, 'log'>, opts?: ProjectMessagesOptions): ProjectedMessages;
+//# sourceMappingURL=project-messages.d.ts.map

package/dist/mode/project-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-messages.d.ts","sourceRoot":"","sources":["../../src/mode/project-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAmB,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAG7B,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,QAKb,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAC3B,MAAM,GAAG,SAAS,CAoBpB;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAsFD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,GAAG,YAAY,EAAE,CA8B1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAQhF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAC7B,IAAI,GAAE,sBAA2B,GAChC,eAAe,EAAE,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAC7B,IAAI,GAAE,sBAA2B,GAChC,iBAAiB,CA2MnB"}