flavor-code 1.2.1

package/dist/context/manager.d.ts

@@ -0,0 +1,65 @@
+import type { HookBus } from "../hooks/bus.js";
+import { type ModelMessage } from "../models/types.js";
+import { type CompactionPolicy } from "./compaction.js";
+export interface ContextManagerOptions {
+    system: SystemPromptSource;
+    /** Dynamic system suffix excluded from the stable prompt-cache prefix. */
+    volatileSystem?: SystemPromptSource;
+    flavor?: string;
+    memory?: string;
+    taskState?: string;
+    /** Stable user preferences, emitted as the final system section for prompt caching. */
+    userMemory?: SystemPromptSource;
+    /** @deprecated Prefer token-based compaction policy. */
+    compactAtChars?: number;
+    toolOutputChars: number;
+    compaction?: Partial<CompactionPolicy>;
+    recentTurns?: number;
+    /** @deprecated Prefer recentTurns. */
+    recentMessages?: number;
+    summarize(messages: readonly ModelMessage[], signal: AbortSignal, onProgress?: CompactProgressCallback): Promise<string>;
+    onCompactProgress?: CompactProgressCallback;
+    hooks: HookBus;
+}
+export type CompactProgressCallback = (percentage: number) => void;
+export type SystemPromptSource = string | readonly string[] | (() => string | readonly string[]);
+export interface ContextSnapshot {
+    compact?: CompactBoundary;
+    /** @deprecated Version 1 session compatibility. */
+    summary?: {
+        role: "system";
+        content: string;
+    };
+    messages: ModelMessage[];
+}
+export interface CompactBoundary {
+    summary: string;
+    compactedAt: string;
+}
+export type CompactReason = "manual" | "reactive";
+export type ContextForkOptions = Partial<Pick<ContextManagerOptions, "summarize" | "onCompactProgress" | "hooks">>;
+export { estimateTokens } from "./compaction.js";
+export declare class ContextManager {
+    #private;
+    constructor(options: ContextManagerOptions);
+    clear(): void;
+    /**
+     * Create an isolated child context whose model-visible prefix is identical to
+     * this context at the instant of the fork. Dynamic system sources are frozen
+     * so later parent changes cannot rewrite the child's reusable prefix.
+     */
+    fork(options?: ContextForkOptions): ContextManager;
+    append(message: ModelMessage): void;
+    appendMany(messages: readonly ModelMessage[]): void;
+    updateTaskState(taskState: string | undefined): void;
+    snapshot(): ContextSnapshot;
+    restore(snapshot: ContextSnapshot): void;
+    messagesForModel(): ModelMessage[];
+    estimatedTokens(): number;
+    needsCompaction(): boolean;
+    get lastRecordedInputTokens(): number | undefined;
+    get consecutiveAutoCompactFailures(): number;
+    recordModelUsage(inputTokens: number): void;
+    prepareForModelCall(signal?: AbortSignal): Promise<boolean>;
+    compact(signal?: AbortSignal, _reason?: CompactReason): Promise<boolean>;
+}

package/dist/context/summarizer.d.ts

@@ -0,0 +1,15 @@
+import type { ModelRegistry } from "../models/registry.js";
+import type { ModelMessage } from "../models/types.js";
+export interface ModelSummarizerOptions {
+    registry: ModelRegistry;
+    modelId(): string;
+    messages: readonly ModelMessage[];
+    signal?: AbortSignal;
+    maxPromptTooLongAttempts?: number;
+    onProgress?: (percentage: number) => void;
+    onUsage?: (usage: {
+        inputTokens: number;
+        outputTokens: number;
+    }) => void;
+}
+export declare function summarizeWithModel(options: ModelSummarizerOptions): Promise<string>;