@oscharko-dev/keiko-server 0.2.5 → 0.2.7

package/dist/chat-compaction-evidence.d.ts

@@ -0,0 +1,12 @@
+import type { ContextCompactionRecord } from "@oscharko-dev/keiko-contracts";
+import type { UiHandlerDeps } from "./deps.js";
+export interface ChatCompactionEvidenceInput {
+    readonly compaction: ContextCompactionRecord | undefined;
+    readonly chatId: string;
+    readonly modelId: string;
+    readonly messageCount: number;
+    readonly startedAt: number;
+    readonly finishedAt: number;
+}
+export declare function persistChatCompactionEvidence(deps: UiHandlerDeps, input: ChatCompactionEvidenceInput): void;
+//# sourceMappingURL=chat-compaction-evidence.d.ts.map

package/dist/chat-compaction-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-compaction-evidence.d.ts","sourceRoot":"","sources":["../src/chat-compaction-evidence.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,MAAM,WAAW,2BAA2B;IAE1C,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAYD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,2BAA2B,GACjC,IAAI,CA8BN"}

package/dist/chat-compaction-evidence.js

@@ -0,0 +1,46 @@
+// ADR-0057 D3: best-effort wiring of the chat history-compaction record into regulated evidence.
+// buildGatewayMessages drops the ContextCompactionRecord that conversationForGatewayWithCompaction
+// produces on the slow path (> MAX_CONTEXT_MESSAGES filtered turns with an active profile). This
+// module persists it via persistCompactionEvidence AFTER the turn completes, redacted and retained
+// under DEFAULT_RETENTION. The raw chatId NEVER reaches the manifest — only sha256Hex(chatId) and a
+// derived runId. Persistence is strictly best-effort: a malformed chatId, an invalid runId, or a
+// throwing store can NEVER fail the chat send. The fast path (no compaction record) is a no-op.
+import { persistCompactionEvidence } from "@oscharko-dev/keiko-evidence";
+import { resolveCostClass } from "@oscharko-dev/keiko-model-gateway";
+import { sha256Hex } from "@oscharko-dev/keiko-security";
+import { currentRedactionSecrets } from "./deps.js";
+// runId = chat-<sha256Hex(chatId)[:16]>-t<messageCount>. Hex-only + the fixed prefix/suffix are all
+// in the assertValidRunId charset [A-Za-z0-9._-]; max length 5+16+2+20 = 43 << 256.
+function compactionRunId(chatIdHash, messageCount) {
+    return `chat-${chatIdHash.slice(0, 16)}-t${String(messageCount)}`;
+}
+// Best-effort persist of one compaction record. EVERYTHING after the fast-path guard — including the
+// chatId hash, runId construction, and persistCompactionEvidence (which itself calls
+// assertValidRunId) — is wrapped so a malformed chatId or a throwing store cannot escape into the
+// send path. The fast path (no record) returns immediately without touching the store.
+export function persistChatCompactionEvidence(deps, input) {
+    if (input.compaction === undefined) {
+        return;
+    }
+    const record = input.compaction;
+    try {
+        const chatIdHash = sha256Hex(input.chatId);
+        persistCompactionEvidence({
+            runId: compactionRunId(chatIdHash, input.messageCount),
+            modelId: input.modelId,
+            records: [record],
+            startedAt: input.startedAt,
+            finishedAt: input.finishedAt,
+            chatIdHash,
+        }, {
+            store: deps.evidenceStore,
+            env: deps.env,
+            additionalSecrets: currentRedactionSecrets(deps),
+            costClassResolver: resolveCostClass,
+        });
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.warn("chat-compaction-evidence: persistence failed (best-effort, send unaffected)", error);
+    }
+}

package/dist/chat-handlers.d.ts

@@ -5,12 +5,19 @@ import { type ConversationAttachment } from "./conversation-validation.js";
 import type { UiHandlerDeps } from "./deps.js";
 import type { RouteContext, RouteResult } from "./routes.js";
 import { type ConversationMemoryRuntimeContext } from "./memory-conversation-context.js";
+import type { ConversationCompactionOutcome } from "./conversation-compaction.js";
+export declare const MAX_CONTEXT_MESSAGES = 24;
 export interface GatewayConversationMessage {
     readonly role: "system" | "user" | "assistant";
     readonly content: string;
 }
 export declare function redactErrorMessage(message: string, deps: UiHandlerDeps): string;
 export declare function desktopChatErrorResult(error: unknown, deps: UiHandlerDeps): RouteResult;
+export declare function usableGatewayMessages(messages: readonly ChatMessage[]): {
+    role: "user" | "assistant";
+    content: string;
+}[];
+export declare function conversationForGateway(messages: readonly ChatMessage[]): GatewayConversationMessage[];
 export interface SendDesktopChatRequest {
     readonly chatId: string;
     readonly projectPath: string;
@@ -34,7 +41,16 @@ export declare function buildChatPatch(chat: Chat, request: SendDesktopChatReque
     selectedModel: string;
     title?: string;
 };
+export declare function deriveCompactionOutcome(deps: UiHandlerDeps, request: SendDesktopChatRequest): ConversationCompactionOutcome;
 export declare function buildGatewayMessages(deps: UiHandlerDeps, request: SendDesktopChatRequest, memoryText: string): GatewayConversationMessage[];
+export interface ChatCompactionTurn {
+    readonly outcome: ConversationCompactionOutcome;
+    readonly request: SendDesktopChatRequest;
+    readonly modelId: string;
+    readonly messageCount: number;
+    readonly startedAt: number;
+}
+export declare function recordChatCompaction(deps: UiHandlerDeps, turn: ChatCompactionTurn): void;
 export declare function handleCreateDesktopChat(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
 export interface PreparedDesktopChatSend {
     readonly request: SendDesktopChatRequest;

package/dist/chat-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handlers.d.ts","sourceRoot":"","sources":["../src/chat-handlers.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,wCAAwC,CAAC;AAuBhD,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS7D,OAAO,EAGL,KAAK,gCAAgC,EACtC,MAAM,kCAAkC,CAAC;AAgB1C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAyKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAE/E;AAOD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,WAAW,CAWvF;AA8BD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAIrC,QAAQ,CAAC,eAAe,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAIrE,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC9D;AAED,UAAU,+BAA+B;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAiPD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,sBAAsB,GAC9B,WAAW,CAYb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,WAAW,CAab;AA8BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,4BAA4B,CAUhF;AA2GD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,4BAA4B,CAAC,CAqCvC;AAiFD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,sBAAsB,EAC/B,aAAa,EAAE,gCAAgC,GAAG,SAAS,EAC3D,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC,CAalD;AAID,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,MAAM,GACd;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAI3C;AAMD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,MAAM,GACjB,0BAA0B,EAAE,CAG9B;AAwDD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAyBtB;AAiCD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,gCAAgC,GAAG,SAAS,CAAC;CACtE;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,uBAAuB,GAAG,WAAW,CAAC,CA8BhD;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAKtB"}
+{"version":3,"file":"chat-handlers.d.ts","sourceRoot":"","sources":["../src/chat-handlers.ts"],"names":[],"mappings":"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"}

package/dist/chat-handlers.js

@@ -24,11 +24,13 @@ import { embedAndStoreMemory } from "./memory-embedding.js";
 import { recordMemoryAudit } from "./memory-audit-handler.js";
 import { captureSalientFromTurn } from "./memory-salience.js";
 import { assertUsableAssistantContent, isLegacyEmptyAssistantPlaceholder, } from "./assistant-response.js";
+import { conversationForGatewayWithCompaction } from "./conversation-compaction.js";
+import { persistChatCompactionEvidence } from "./chat-compaction-evidence.js";
 const DEFAULT_CHAT_MODEL = "example-chat-model";
 const DEFAULT_CHAT_TITLE = "New chat";
 const MAX_BODY_BYTES = 128_000;
 const MAX_CHAT_INPUT_CHARS = 16_000;
-const MAX_CONTEXT_MESSAGES = 24;
+export const MAX_CONTEXT_MESSAGES = 24;
 class BodyTooLargeError extends Error {
     constructor() {
         super("request body too large");
@@ -204,11 +206,17 @@ function messageForGateway(message) {
     }
     return { role: message.role, content: message.content };
 }
-function conversationForGateway(messages) {
-    const usable = messages
+// The map+filter projection shared by conversationForGateway and the PR4-W2 compaction shim
+// (conversation-compaction.ts). Returns the full filtered, ORDER-PRESERVED set of user/assistant
+// turns BEFORE the recent-window slice — so the shim's "post-filter count", kept window, and
+// dropped prefix are derived from the exact same selection the slice operates on.
+export function usableGatewayMessages(messages) {
+    return messages
         .map(messageForGateway)
-        .filter((message) => message !== null)
-        .slice(-MAX_CONTEXT_MESSAGES);
+        .filter((message) => message !== null);
+}
+export function conversationForGateway(messages) {
+    const usable = usableGatewayMessages(messages).slice(-MAX_CONTEXT_MESSAGES);
     return [
         {
             role: "system",
@@ -688,48 +696,90 @@ export function buildChatPatch(chat, request, modelId) {
 // memory text). Shared by the buffered (persistModelChatTurn) and streaming
 // (handleSendDesktopChatStream) paths so both send a byte-identical prompt. `memoryText` is
 // `memory.context.text`.
+// ADR-0057 D3: the full compaction outcome for the latest turn, including the optional
+// ContextCompactionRecord that buildGatewayMessages drops. Both send paths call this to capture the
+// record for best-effort regulated evidence; buildGatewayMessages delegates here for the messages.
+// Reads store.listMessages once — identical history slice the prompt is built from.
+export function deriveCompactionOutcome(deps, request) {
+    return conversationForGatewayWithCompaction(deps.store.listMessages(request.chatId), {
+        contextProfile: deps.contextProfile,
+    });
+}
 export function buildGatewayMessages(deps, request, memoryText) {
-    const history = conversationForGateway(deps.store.listMessages(request.chatId));
-    return applyDocumentContextToLatestUserTurn(history, request, memoryText);
+    // PR4-W2 (ADR-0055 D3): route history assembly through the predicate-gated compaction shim. On
+    // the fast path (no profile or <= MAX_CONTEXT_MESSAGES filtered turns) the shim returns the EXACT
+    // conversationForGateway(...) value, so this is byte-identical to the pre-PR4 path.
+    const { messages } = deriveCompactionOutcome(deps, request);
+    return applyDocumentContextToLatestUserTurn(messages, request, memoryText);
+}
+// ADR-0057 D3: best-effort persist of the turn's compaction record AFTER the response completes.
+// finishedAt is captured here (post-turn). Shared by the buffered and streaming send paths so the
+// runId + timing are identical. Never throws into the send path (persistChatCompactionEvidence is
+// fully guarded and a no-op on the fast path).
+export function recordChatCompaction(deps, turn) {
+    persistChatCompactionEvidence(deps, {
+        compaction: turn.outcome.compaction,
+        chatId: turn.request.chatId,
+        modelId: turn.modelId,
+        messageCount: turn.messageCount,
+        startedAt: turn.startedAt,
+        finishedAt: Date.now(),
+    });
 }
 async function persistModelChatTurn(deps, request, chat, modelId, memoryContext) {
     const model = deps.modelPortFactory(modelId);
     if (model === undefined) {
         return { status: 400, body: errorBody("NO_MODEL", "No model provider is configured.") };
     }
+    // ADR-0057 D3: pin the pre-user-message count BEFORE createUserMessage stores the turn, so the
+    // compaction-evidence runId is collision-free and matches the streaming path's lifecycle moment.
+    const messageCountBeforeTurn = deps.store.listMessages(request.chatId).length;
+    const startedAt = Date.now();
     try {
         const memory = memoryContext === undefined
             ? emptyMemoryResult(false)
             : await buildMemoryResult(request, deps, memoryContext);
         const userMessage = createUserMessage(deps, request);
+        const outcome = deriveCompactionOutcome(deps, request);
         const messages = buildGatewayMessages(deps, request, memory.context.text);
-        const response = await model.call({
+        const response = await model.call({ modelId, messages, stream: false }, new AbortController().signal);
+        recordChatCompaction(deps, {
+            outcome,
+            request,
             modelId,
-            messages,
-            stream: false,
-        }, new AbortController().signal);
-        // Issue #631 — redact the model's raw content before persisting and before returning it to
-        // the browser. A model that echoes a secret from its context (e.g. an apiKey injected via
-        // system prompt) would otherwise surface it un-redacted on the success path, mirroring the
-        // grounded-QA path (grounded-qa.ts line 549) which already applies deps.redactor here.
-        const redactedContent = deps.redactor(response.content);
-        const assistantMessage = createAssistantMessage(deps, request, redactedContent, modelId);
-        const memoryActions = await collectMemoryActions(deps, request, memoryContext, modelId, redactedContent);
-        const chatPatch = buildChatPatch(chat, request, modelId);
-        return {
-            status: 200,
-            body: {
-                chat: deps.store.updateChat(request.chatId, chatPatch),
-                messages: [userMessage, assistantMessage],
-                usage: response.usage,
-                memory: { ...memory, actions: memoryActions },
-            },
-        };
+            messageCount: messageCountBeforeTurn,
+            startedAt,
+        });
+        return await finalizeBufferedTurn(deps, { request, chat, modelId, memoryContext }, memory, {
+            userMessage,
+            response,
+        });
     }
     catch (error) {
         return desktopChatErrorResult(error, deps);
     }
 }
+// Post-response assembly for the buffered send: redacts the model content, persists the assistant
+// message, collects memory actions, and builds the 200 body. Extracted to keep persistModelChatTurn
+// within the function-length budget after the ADR-0057 D3 compaction wiring.
+async function finalizeBufferedTurn(deps, turn, memory, result) {
+    const { request, chat, modelId, memoryContext } = turn;
+    // Issue #631 — redact the model's raw content before persisting and before returning it to the
+    // browser, mirroring the grounded-QA path which already applies deps.redactor here.
+    const redactedContent = deps.redactor(result.response.content);
+    const assistantMessage = createAssistantMessage(deps, request, redactedContent, modelId);
+    const memoryActions = await collectMemoryActions(deps, request, memoryContext, modelId, redactedContent);
+    const chatPatch = buildChatPatch(chat, request, modelId);
+    return {
+        status: 200,
+        body: {
+            chat: deps.store.updateChat(request.chatId, chatPatch),
+            messages: [result.userMessage, assistantMessage],
+            usage: result.response.usage,
+            memory: { ...memory, actions: memoryActions },
+        },
+    };
+}
 export async function handleCreateDesktopChat(ctx, deps) {
     const body = await readJsonObject(ctx.req);
     if (isRouteResult(body))

package/dist/chat-stream-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-stream-handlers.d.ts","sourceRoot":"","sources":["../src/chat-stream-handlers.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAyK/C,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CAyBzB"}
+{"version":3,"file":"chat-stream-handlers.d.ts","sourceRoot":"","sources":["../src/chat-stream-handlers.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAuL/C,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,cAAc,CAAC,CAyBzB"}

package/dist/chat-stream-handlers.js

@@ -10,7 +10,7 @@
 import { SSE_HEADERS } from "./sse.js";
 import { writeOrDestroy } from "./sse-write.js";
 import { STREAMING, errorBody } from "./routes.js";
-import { buildChatPatch, buildGatewayMessages, buildMemoryResult, collectMemoryActions, createAssistantMessage, createUserMessage, desktopChatErrorResult, emptyMemoryResult, prepareDesktopChatSend, } from "./chat-handlers.js";
+import { buildChatPatch, buildGatewayMessages, buildMemoryResult, collectMemoryActions, createAssistantMessage, createUserMessage, deriveCompactionOutcome, desktopChatErrorResult, emptyMemoryResult, prepareDesktopChatSend, recordChatCompaction, } from "./chat-handlers.js";
 // One SSE message. JSON.stringify never emits a raw newline inside a string (newlines escape to
 // `\n`), so a single `data:` line is always valid framing — no manual escaping, mirroring sse.ts.
 function sseMessage(event, data) {
@@ -93,7 +93,12 @@ function errorEvent(error, deps) {
 async function streamAndPersist(ctx, deps, prepared, callStream, controller) {
     const { request, chat, modelId, memoryContext } = prepared;
     const memory = await resolveMemory(deps, request, memoryContext);
+    // ADR-0057 D3: pin the pre-user-message count BEFORE createUserMessage, mirroring the buffered
+    // path's lifecycle moment so the compaction-evidence runId is identical across both paths.
+    const messageCountBeforeTurn = deps.store.listMessages(request.chatId).length;
+    const startedAt = Date.now();
     const userMessage = createUserMessage(deps, request);
+    const outcome = deriveCompactionOutcome(deps, request);
     const messages = buildGatewayMessages(deps, request, memory.context.text);
     const stream = callStream({ modelId, messages }, controller.signal);
     const turn = await streamConversation(ctx, deps, stream, controller);
@@ -102,6 +107,13 @@ async function streamAndPersist(ctx, deps, prepared, callStream, controller) {
         return;
     }
     const payload = await persistStreamedTurn(deps, request, chat, modelId, memory, memoryContext, turn, userMessage);
+    recordChatCompaction(deps, {
+        outcome,
+        request,
+        modelId,
+        messageCount: messageCountBeforeTurn,
+        startedAt,
+    });
     ctx.res.write(sseMessage("done", payload));
 }
 export async function handleSendDesktopChatStream(ctx, deps) {

package/dist/conversation-compaction.d.ts

@@ -0,0 +1,12 @@
+import { type ContextCompactionRecord, type ContextProfile } from "@oscharko-dev/keiko-contracts";
+import type { ChatMessage } from "./store/index.js";
+import { type GatewayConversationMessage } from "./chat-handlers.js";
+export interface ConversationCompactionOptions {
+    readonly contextProfile?: ContextProfile | undefined;
+}
+export interface ConversationCompactionOutcome {
+    readonly messages: GatewayConversationMessage[];
+    readonly compaction?: ContextCompactionRecord | undefined;
+}
+export declare function conversationForGatewayWithCompaction(messages: readonly ChatMessage[], opts?: ConversationCompactionOptions): ConversationCompactionOutcome;
+//# sourceMappingURL=conversation-compaction.d.ts.map

package/dist/conversation-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-compaction.d.ts","sourceRoot":"","sources":["../src/conversation-compaction.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CAC3D;AAgBD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,IAAI,GAAE,6BAAkC,GACvC,6BAA6B,CAM/B"}

package/dist/conversation-compaction.js

@@ -0,0 +1,102 @@
+// PR4-W2 chat history-compaction splice (ADR-0055 D3) — the ONE genuine behavioral change in the
+// context-engineering milestone. A PURE, deterministic, offline, no-clock, no-random shim that
+// wraps conversationForGateway (chat-handlers.ts).
+//
+// ACTIVATION PREDICATE (the unchanged-guarantee, ADR-0055 D6):
+//   opts.contextProfile === undefined  ||  filtered.length <= MAX_CONTEXT_MESSAGES
+// When true, this returns the EXACT return value of conversationForGateway(messages) — no copy,
+// no spread, no transform — so short sessions and no-profile callers are byte-identical to today.
+//
+// SLOW PATH (profile present AND > MAX_CONTEXT_MESSAGES filtered turns): the older turns that the
+// existing slice HARD-DROPS are folded into a single deterministic, REDACTED, byte-bounded summary
+// segment (role "user", model-agnostic-safe — not a second system turn) placed immediately AFTER
+// the existing system message, accompanied by a validated ContextCompactionRecord. No model call.
+import { CONTEXT_ENGINEERING_SCHEMA_VERSION, estimateTokens, validateContextCompactionRecord, } from "@oscharko-dev/keiko-contracts";
+import { redact } from "@oscharko-dev/keiko-security";
+import { MAX_CONTEXT_MESSAGES, conversationForGateway, usableGatewayMessages, } from "./chat-handlers.js";
+// Per-dropped-message redacted snippet budget (UTF-8 bytes). Bounds a single noisy turn.
+const SNIPPET_BYTE_BUDGET = 200;
+// Total token budget for the whole synthetic summary segment (a few KB at ~3.5 bytes/token).
+const SUMMARY_TOKEN_BUDGET = 1024;
+// Deterministic, offline, predicate-gated wrapper over conversationForGateway. On the fast path it
+// returns the existing function's value verbatim; on the slow path it inserts a redacted summary
+// after the system message so platform instructions remain first.
+export function conversationForGatewayWithCompaction(messages, opts = {}) {
+    const filtered = usableGatewayMessages(messages);
+    if (opts.contextProfile === undefined || filtered.length <= MAX_CONTEXT_MESSAGES) {
+        return { messages: conversationForGateway(messages) };
+    }
+    return buildCompactedOutcome(messages, filtered);
+}
+function buildCompactedOutcome(messages, filtered) {
+    const dropped = toDroppedTurns(filtered.slice(0, filtered.length - MAX_CONTEXT_MESSAGES));
+    const summaryContent = buildSummaryContent(dropped);
+    const summarySegment = { role: "user", content: summaryContent };
+    const record = buildRecord(dropped, summaryContent);
+    const gatewayMessages = conversationForGateway(messages);
+    const [systemMessage, ...recentMessages] = gatewayMessages;
+    return {
+        messages: systemMessage === undefined
+            ? [summarySegment]
+            : [systemMessage, summarySegment, ...recentMessages],
+        compaction: record,
+    };
+}
+function toDroppedTurns(prefix) {
+    return prefix.map((turn, index) => ({
+        role: turn.role,
+        content: turn.content,
+        stableId: `history-msg-${String(index)}`,
+    }));
+}
+// Redact + byte-bound a single dropped turn to a one-line snippet. UTF-8-safe truncation.
+function snippetFor(turn) {
+    const redacted = redact(turn.content).replace(/\s+/gu, " ").trim();
+    const bytes = new TextEncoder().encode(redacted);
+    if (bytes.length <= SNIPPET_BYTE_BUDGET) {
+        return redacted;
+    }
+    const slice = bytes.slice(0, SNIPPET_BYTE_BUDGET);
+    return new TextDecoder("utf-8", { fatal: false }).decode(slice).trimEnd() + "…";
+}
+const SUMMARY_HEADER = "[Automated summary of earlier conversation turns — older messages were compacted to fit the " +
+    "context window. The verbatim recent turns follow below.]";
+function buildSummaryContent(dropped) {
+    const lines = [SUMMARY_HEADER, `Dropped ${String(dropped.length)} earlier turn(s):`];
+    let omitted = 0;
+    for (const turn of dropped) {
+        const candidate = `- [${turn.role}] ${snippetFor(turn)}`;
+        const next = [...lines, candidate].join("\n");
+        if (estimateTokens(next) > SUMMARY_TOKEN_BUDGET) {
+            omitted += 1;
+            continue;
+        }
+        lines.push(candidate);
+    }
+    if (omitted > 0) {
+        lines.push(`…and ${String(omitted)} further turn(s) omitted to stay within the summary budget.`);
+    }
+    return lines.join("\n");
+}
+function sourceSpansFor(dropped) {
+    return dropped.map((turn) => ({ kind: "message", stableId: turn.stableId }));
+}
+function buildRecord(dropped, summaryContent) {
+    const tokensBefore = dropped.reduce((sum, turn) => sum + estimateTokens(turn.content), 0);
+    const record = {
+        schemaVersion: CONTEXT_ENGINEERING_SCHEMA_VERSION,
+        laneId: "history-summary",
+        reason: "history-window",
+        itemsBefore: dropped.length,
+        itemsAfter: 0,
+        tokensBefore,
+        tokensAfter: estimateTokens(summaryContent),
+        orderedAt: dropped.length,
+        sourceSpans: sourceSpansFor(dropped),
+    };
+    const validation = validateContextCompactionRecord(record);
+    if (!validation.ok) {
+        throw new Error(`conversation-compaction produced an invalid record: ${validation.reasons.join(", ")}`);
+    }
+    return record;
+}

package/dist/deps.d.ts

@@ -1,5 +1,6 @@
 import { type EnvSource, type GatewayConfig } from "@oscharko-dev/keiko-model-gateway";
 import type { ModelPort } from "@oscharko-dev/keiko-harness";
+import { type ContextProfile } from "@oscharko-dev/keiko-contracts";
 import type { EvidenceStore } from "@oscharko-dev/keiko-evidence";
 import type { RunRegistry } from "./runs.js";
 import { type UiStore } from "./store/index.js";
@@ -56,6 +57,7 @@ export interface UiHandlerDeps {
     readonly relationship?: RelationshipHandlerDeps | undefined;
     readonly evidenceDir?: string | undefined;
     readonly localKnowledgeKeyProvider?: KnowledgeStoreKeyProvider | undefined;
+    readonly contextProfile?: ContextProfile | undefined;
 }
 export interface BuildHandlerDepsOptions {
     readonly configPath: string | undefined;

package/dist/deps.d.ts.map

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

package/dist/deps.js

@@ -13,6 +13,7 @@ import { resolveCostClass } from "@oscharko-dev/keiko-model-gateway";
 import { writeSideFile } from "@oscharko-dev/keiko-evidence";
 import { deepRedactStrings } from "@oscharko-dev/keiko-evidence";
 import { keikoApiKeySecretValues } from "@oscharko-dev/keiko-security";
+import { DEFAULT_CONTEXT_PROFILE } from "@oscharko-dev/keiko-contracts";
 import { nodeWorkspaceFs } from "@oscharko-dev/keiko-workspace/internal/fs";
 import { createNodeEvidenceStore, resolveEvidenceDir } from "@oscharko-dev/keiko-evidence";
 import { dirname, join } from "node:path";
@@ -430,7 +431,6 @@ export function buildUiHandlerDeps(options) {
     const liveRedactor = (value) => deepRedactStrings(value, redactString);
     const { store: uiStore, relationship } = composePersistence(options.store, resolvedUiDbPath, redactString, options.env);
     const preferredProjectPath = seedInitialProject(uiStore, resolvedUiDbPath, options.initialProjectPath);
-    const peripherals = buildPeripherals(options, uiStore, evidenceStore, redactString, liveRedactor);
     return {
         config,
         configPresent,
@@ -450,7 +450,8 @@ export function buildUiHandlerDeps(options) {
         gatewayModelDiscovery: options.gatewayModelDiscovery,
         figmaCredentialTester: options.figmaCredentialTester,
         localKnowledgeKeyProvider: createLocalKnowledgeKeyProvider({ env: options.env }),
-        ...peripherals,
+        contextProfile: DEFAULT_CONTEXT_PROFILE,
+        ...buildPeripherals(options, uiStore, evidenceStore, redactString, liveRedactor),
         consolidationJobs: createConsolidationJobRegistry(),
         ...(relationship === undefined ? {} : { relationship }),
     };

package/dist/grounded-context-diagnostics.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectedContextPack } from "@oscharko-dev/keiko-contracts/connected-context";
+import { type ContextAssemblyDiagnostics, type ContextProfile } from "@oscharko-dev/keiko-contracts";
+export declare function deriveGroundedContextAssembly(pack: ConnectedContextPack, profile: ContextProfile): ContextAssemblyDiagnostics;
+export declare function attachContextBudgetDiagnostics(pack: ConnectedContextPack, profile: ContextProfile): ConnectedContextPack;
+//# sourceMappingURL=grounded-context-diagnostics.d.ts.map

package/dist/grounded-context-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounded-context-diagnostics.d.ts","sourceRoot":"","sources":["../src/grounded-context-diagnostics.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAEL,KAAK,0BAA0B,EAE/B,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AAqEvC,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,cAAc,GACtB,0BAA0B,CAE5B;AAOD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,cAAc,GACtB,oBAAoB,CAMtB"}

package/dist/grounded-context-diagnostics.js

@@ -0,0 +1,77 @@
+// PR4-W1 grounded diagnostics observer (ADR-0055 D1). A PURE, no-IO, no-clock function that
+// accepts a fully assembled `ConnectedContextPack` and a `ContextProfile` and returns a pack
+// whose `diagnostics.contextBudget?` is populated with a deterministic `ContextBudget` derived by
+// running the keiko-workflows allocator over lanes mapped from the pack.
+//
+// NON-NEGOTIABLE INVARIANT (AC5): this observer MUST NOT touch any field a prompt builder reads.
+// `buildGroundedGatewayMessages` (grounded-qa.ts) reads only pack.schemaVersion / stableId /
+// scope / query / budget / usage / omitted / files / uncertainty — never pack.diagnostics. The
+// observer therefore changes ONLY the additive optional `diagnostics.contextBudget?` field while
+// preserving the existing `diagnostics.rankedCandidates` (the first-lexical-ring explainability).
+// pack.files, pack.budget, pack.usage and pack.stableId are returned reference-identical.
+import { CONTEXT_ENGINEERING_SCHEMA_VERSION, } from "@oscharko-dev/keiko-contracts";
+import { allocateContext, DEFAULT_CONTEXT_BUDGET, } from "@oscharko-dev/keiko-workflows";
+// The grounded path carries repository evidence excerpts only; the system-contract / user-task /
+// plan / tool / memory / history / verification lanes are not assembled here, so they are passed
+// empty. Diagnostics over the populated repo-evidence lane are the W1 deliverable.
+function repoEvidenceLaneItems(pack) {
+    const items = [];
+    for (const file of pack.files) {
+        for (const excerpt of file.excerpts) {
+            items.push({
+                id: excerpt.atom.stableId,
+                text: excerpt.content,
+                score: excerpt.atom.score,
+            });
+        }
+    }
+    return items;
+}
+function groundedLanes(pack) {
+    return [{ laneId: "repo-evidence", items: repoEvidenceLaneItems(pack) }];
+}
+// Builds a ContextBudget whose `profile` is the supplied profile (so validateContextBudget's
+// profile-identity check holds) while reusing the canonical, tunable lane rows. Pure — no clock,
+// no IO, never mutates the inputs.
+function budgetForProfile(profile) {
+    return {
+        schemaVersion: CONTEXT_ENGINEERING_SCHEMA_VERSION,
+        profile,
+        lanes: DEFAULT_CONTEXT_BUDGET.lanes,
+    };
+}
+function diagnosticsWithBudget(existing, budget) {
+    const rankedCandidates = existing?.rankedCandidates ?? [];
+    return { ...existing, rankedCandidates, contextBudget: budget };
+}
+// SHARED lane-derivation + allocation pass (single source of truth for the observer AND the
+// evidence producer below). Pure, no-IO, no-clock: maps the pack's repo-evidence lane, builds the
+// profile budget, and runs the deterministic allocator once. Both the BFF/UI ContextBudget slot
+// and the regulated ContextAssemblyDiagnostics are projected from THIS result — there is no
+// divergent derivation path that could let the two views disagree for the same pack + profile.
+function allocateGroundedContext(pack, profile) {
+    const budget = budgetForProfile(profile);
+    const result = allocateContext({ profile, budget, lanes: groundedLanes(pack) });
+    return { budget, result };
+}
+// EVIDENCE producer (ADR-0056 W3). Returns the rich ContextAssemblyDiagnostics
+// (allocateContext(...).diagnostics) for the pack's repo-evidence lane under the supplied profile.
+// This is the value persisted to EvidenceManifest.contextAssembly? — NOT the ContextBudget that
+// ContextPackDiagnostics.contextBudget? carries. Derives the lane via the same shared helper the
+// observer uses, so the persisted diagnostics describe exactly the budget plan the observer
+// attached. Pure and deterministic.
+export function deriveGroundedContextAssembly(pack, profile) {
+    return allocateGroundedContext(pack, profile).result.diagnostics;
+}
+// Runs the deterministic allocator over the pack-derived lanes and attaches the resulting
+// ContextBudget to pack.diagnostics.contextBudget. The allocator pass exercises the budget plan
+// over real lane items (proving the budget is meaningful for this pack); the attached value is the
+// ContextBudget that ContextPackDiagnostics.contextBudget? carries (the only diagnostics slot the
+// pack contract exposes). All other pack fields are returned unchanged.
+export function attachContextBudgetDiagnostics(pack, profile) {
+    const { budget } = allocateGroundedContext(pack, profile);
+    return {
+        ...pack,
+        diagnostics: diagnosticsWithBudget(pack.diagnostics, budget),
+    };
+}

package/dist/grounded-orchestrator.d.ts

@@ -1,4 +1,5 @@
 import { type ConnectedContextPack, type ExplorationBudget, type RetrievalQuery, type SelectedScope } from "@oscharko-dev/keiko-contracts/connected-context";
+import type { ContextProfile } from "@oscharko-dev/keiko-contracts";
 import { type ClarificationPrompt, type ExplorationPlan, type MicroIndex } from "@oscharko-dev/keiko-workflows";
 import { DEFAULT_SEARCH_LIMITS, type WorkspaceFs, type WorkspaceInfo } from "@oscharko-dev/keiko-workspace";
 import { type GroundedAnswerPayload } from "./grounded-answer.js";
@@ -19,6 +20,7 @@ export interface OrchestratorDeps {
     readonly detectWorkspace?: (root: string, fs: WorkspaceFs) => WorkspaceInfo;
     readonly recordPlan?: (plan: ExplorationPlan) => void;
     readonly microIndex?: MicroIndex;
+    readonly contextProfile?: ContextProfile | undefined;
 }
 export interface OrchestratorOutput {
     readonly pack: ConnectedContextPack;

package/dist/grounded-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grounded-orchestrator.d.ts","sourceRoot":"","sources":["../src/grounded-orchestrator.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAGtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAUL,KAAK,mBAAmB,EAExB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAIhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,qBAAqB,EAerB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AASlG,MAAM,WAAW,gBAAgB;IAG/B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE1C,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC;IAE1B,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,KAAK,aAAa,CAAC;IAE5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAEtD,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAKD,qBAAa,wBAAyB,SAAQ,KAAK;aACd,aAAa,EAAE,mBAAmB;gBAAlC,aAAa,EAAE,mBAAmB;CAItE;AAMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAgBhF;AA25BD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM/E;AAw5BD,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"grounded-orchestrator.d.ts","sourceRoot":"","sources":["../src/grounded-orchestrator.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,oBAAoB,EAGzB,KAAK,iBAAiB,EAGtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAUL,KAAK,mBAAmB,EAExB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAIhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,qBAAqB,EAiBrB,KAAK,WAAW,EAChB,KAAK,aAAa,EAGnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAUlG,MAAM,WAAW,gBAAgB;IAG/B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE1C,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC;IAE1B,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,KAAK,aAAa,CAAC;IAE5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAEtD,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAKjC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAKD,qBAAa,wBAAyB,SAAQ,KAAK;aACd,aAAa,EAAE,mBAAmB;gBAAlC,aAAa,EAAE,mBAAmB;CAItE;AAMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAgBhF;AAk8BD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM/E;AA09BD,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAC"}