@moxxy/sdk 0.14.2 → 0.14.3

package/dist/mode-helpers.d.ts

@@ -1,178 +1,18 @@
-import type { ProviderMessage, TokenUsage } from './provider.js';
-import type { ModeContext } from './mode.js';
-import type { StopReason } from './provider-utils.js';
-import type { Skill } from './skill.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}`.
+ * Barrel for the shared mode/loop helpers. The implementations now live in
+ * focused single-responsibility modules under `./mode/`; this file re-exports
+ * them so every existing `from './mode-helpers.js'` import (and the
+ * `@moxxy/sdk` index barrel) keeps working byte-identically.
  *
- * 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;
-}
-/** 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;
-}
-/**
- * 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;
-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>;
-/**
- * Run a single-shot (no-tools) provider turn — the shape every planner /
- * synthesis phase shares. Runs context management (compaction + elision),
- * emits the `provider_request` bookend, streams the response with tools
- * disabled, then emits either an `error` event (returning `null`) or the
- * `provider_response` bookend (returning the collected text).
- *
- * Replaces the ~40-line block each mode phase used to inline; centralizing it
- * keeps event emission uniform and means a fix here (e.g. always running
- * elision) lands for every loop strategy at once.
- */
-export declare function runSingleShotTurn(ctx: ModeContext, messages: ReadonlyArray<ProviderMessage>, opts?: {
-    maxTokens?: number;
-}): Promise<string | null>;
-/**
- * Sliding-window detector for "model keeps making the same tool call".
- *
- * When the same `(toolName, input)` pair appears `repeatThreshold` times in
- * the last `windowSize` calls, the model is almost certainly stuck — polling a
- * tool that returns the same thing, mis-handling an error, etc. Bail early
- * instead of burning through the iteration cap.
- *
- * Shared across every loop strategy so detection is uniform — previously each
- * mode re-rolled this, and one copy used a non-canonical `JSON.stringify`
- * signature that silently missed key-reordered repeats.
- */
-export interface StuckSignal {
-    /** True when the loop guard should trip. */
-    readonly stuck: boolean;
-    /** Repeat count behind the trip — for the error message. */
-    readonly count: number;
-    /**
-     * `exact` = the same (tool, full-input) repeated `repeatThreshold` times.
-     * `near`  = the same (tool, identity arg — url / file_path / command / …)
-     *           repeated `nearThreshold` times while only volatile args (maxBytes,
-     *           timeoutMs) varied. Catches the "refetch the same URL with a bigger
-     *           maxBytes over and over" loop the exact check sails past.
-     */
-    readonly kind: 'exact' | 'near';
-}
-export interface StuckLoopDetector {
-    readonly windowSize: number;
-    readonly repeatThreshold: number;
-    /** Record the call and report whether the loop guard should trip. */
-    record(toolName: string, input: unknown): StuckSignal;
-}
-export declare function createStuckLoopDetector(opts?: {
-    windowSize?: number;
-    repeatThreshold?: number;
-    nearWindowSize?: number;
-    nearThreshold?: number;
-}): StuckLoopDetector;
-/**
- * Stable, key-order-canonical hash of a tool call's input, so `{a:1,b:2}` and
- * `{b:2,a:1}` produce the same key. Use for any "have I seen this call before"
- * comparison — a raw `JSON.stringify` is NOT order-stable.
- */
-export declare function stableHash(input: unknown): string;
+ *  - `./mode/project-messages.ts` — event-log → ProviderMessage projection
+ *  - `./mode/collect-stream.ts`   — provider-stream collection
+ *  - `./mode/single-shot.ts`      — single-shot (no-tools) provider turn
+ *  - `./mode/stuck-loop.ts`       — sliding-window stuck-tool-call detector
+ *  - `./mode/stable-hash.ts`      — key-order-canonical input hash util
+ */
+export { ELISION_SYSTEM_NOTE, buildSystemPromptWithSkills, projectMessagesFromLog, projectMessages, type ProjectMessagesOptions, type ProjectedMessages, } from './mode/project-messages.js';
+export { collectProviderStream, type CollectedToolUse, type StreamResult, } from './mode/collect-stream.js';
+export { runSingleShotTurn } from './mode/single-shot.js';
+export { createStuckLoopDetector, type StuckLoopDetector, type StuckSignal, } from './mode/stuck-loop.js';
+export { stableHash } from './mode/stable-hash.js';
 //# sourceMappingURL=mode-helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mode-helpers.d.ts","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mode-helpers.d.ts","sourceRoot":"","sources":["../src/mode-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}