common-memory-core 0.2.0

package/dist/memory-manager/openai/openai-chat-adapter.js

@@ -0,0 +1,51 @@
+import { createHmac } from 'node:crypto';
+import { MemoryModelError } from '../contracts/errors.js';
+import { RemoteHttpMemoryModel } from './remote-http.js';
+import { validateRemoteTuning } from './options.js';
+export class OpenAIChatMemoryModel extends RemoteHttpMemoryModel {
+    #tuning;
+    constructor(options) { super(options, 'chat/completions'); this.#tuning = validateRemoteTuning(options, 'chat_completions'); }
+    serialize(request) {
+        return JSON.stringify({ model: this.model, max_tokens: this.maxOutputTokens, messages: [
+                { role: 'system', content: `${request.prompt}\n\nReturn one JSON object conforming to this complete JSON Schema (${request.schemaName ?? 'memory_maintenance_v2'}):\n${JSON.stringify(request.schema)}` },
+                { role: 'user', content: JSON.stringify(request.projection) },
+            ], response_format: { type: 'json_object' }, ...(this.#tuning.thinking === undefined ? {} : { thinking: this.#tuning.thinking }), ...(this.#tuning.enableThinking === undefined ? {} : { enable_thinking: this.#tuning.enableThinking }) });
+    }
+    decode(envelope, fingerprintKey) { return decodeChatEnvelope(envelope, fingerprintKey); }
+}
+export function decodeChatEnvelope(value, fingerprintKey) {
+    const root = record(value);
+    if (root.error != null || !Array.isArray(root.choices) || root.choices.length !== 1)
+        invalid();
+    const choice = record(root.choices[0]);
+    if (choice.finish_reason === 'length')
+        invalid('output_truncated');
+    if (choice.finish_reason === 'tool_calls' || choice.finish_reason === 'function_call')
+        invalid('tool_call');
+    if (choice.finish_reason !== 'stop')
+        invalid('incomplete_output');
+    const message = record(choice.message);
+    if (message.role !== 'assistant')
+        invalid();
+    if (message.function_call != null || message.tool_calls != null && (!Array.isArray(message.tool_calls) || message.tool_calls.length > 0))
+        invalid('tool_call');
+    const u = root.usage && typeof root.usage === 'object' && !Array.isArray(root.usage) ? root.usage : {};
+    const usage = { ...(finite(u.prompt_tokens) ? { inputTokens: u.prompt_tokens } : {}), ...(finite(u.completion_tokens) ? { outputTokens: u.completion_tokens } : {}), ...(finite(u.total_tokens) ? { totalTokens: u.total_tokens } : {}) };
+    if (typeof message.refusal === 'string' && message.refusal)
+        return { kind: 'refusal', category: 'provider_refusal', fingerprint: createHmac('sha256', fingerprintKey).update(message.refusal, 'utf8').digest('hex'), usage };
+    if (message.refusal != null && message.refusal !== '' || typeof message.content !== 'string')
+        invalid();
+    let body;
+    try {
+        body = JSON.parse(message.content);
+    }
+    catch {
+        invalid('invalid_json');
+    }
+    return { kind: 'output', body, usage };
+}
+function finite(value) { return typeof value === 'number' && Number.isFinite(value) && value >= 0; }
+function record(value) { if (!value || typeof value !== 'object' || Array.isArray(value))
+    invalid(); return value; }
+function invalid(reason = 'invalid_envelope') { throw new MemoryModelError('INVALID_RESPONSE', 'Provider returned an invalid Chat envelope', false, { stage: reason === 'invalid_json' ? 'model_output' : 'response_envelope', reason, retryable: false }); }
+//# sourceMappingURL=openai-chat-adapter.js.map

package/dist/memory-manager/openai/openai-chat-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-chat-adapter.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/openai-chat-adapter.ts"],"names":[],"mappings":"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"}

package/dist/memory-manager/openai/openai-responses-adapter.d.ts

@@ -0,0 +1,15 @@
+import type { ApprovedModelRequest, MemoryModelResult } from '../contracts/model-port.js';
+import { RemoteHttpMemoryModel, type RemoteHttpOptions } from './remote-http.js';
+import { type ReasoningEffort } from './options.js';
+export { normalizeOpenAICompatibleBaseUrl } from './remote-http.js';
+export interface OpenAIResponsesMemoryModelOptions extends RemoteHttpOptions {
+    reasoningEffort?: ReasoningEffort;
+}
+export declare class OpenAIResponsesMemoryModel extends RemoteHttpMemoryModel {
+    #private;
+    constructor(options: OpenAIResponsesMemoryModelOptions);
+    protected serialize(request: ApprovedModelRequest): string;
+    protected decode(envelope: unknown, fingerprintKey: string): MemoryModelResult;
+}
+export declare function createOpenAIResponsesMemoryModel(options: OpenAIResponsesMemoryModelOptions): OpenAIResponsesMemoryModel;
+//# sourceMappingURL=openai-responses-adapter.d.ts.map

package/dist/memory-manager/openai/openai-responses-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-adapter.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/openai/openai-responses-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAAG,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE;AAClH,qBAAa,0BAA2B,SAAQ,qBAAqB;;gBAEvD,OAAO,EAAE,iCAAiC;IACtD,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAG1D,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB;CAC/E;AACD,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,0BAA0B,CAAoD"}

package/dist/memory-manager/openai/openai-responses-adapter.js

@@ -0,0 +1,14 @@
+import { decodeResponsesEnvelope } from './response-decoder.js';
+import { RemoteHttpMemoryModel } from './remote-http.js';
+import { validateRemoteTuning } from './options.js';
+export { normalizeOpenAICompatibleBaseUrl } from './remote-http.js';
+export class OpenAIResponsesMemoryModel extends RemoteHttpMemoryModel {
+    #reasoningEffort;
+    constructor(options) { super(options, 'responses'); this.#reasoningEffort = validateRemoteTuning(options, 'responses').reasoningEffort; }
+    serialize(request) {
+        return JSON.stringify({ model: this.model, store: false, ...(this.#reasoningEffort === undefined ? {} : { reasoning: { effort: this.#reasoningEffort } }), max_output_tokens: this.maxOutputTokens, input: [{ role: 'system', content: [{ type: 'input_text', text: request.prompt }] }, { role: 'user', content: [{ type: 'input_text', text: JSON.stringify(request.projection) }] }], text: { format: { type: 'json_schema', name: request.schemaName ?? 'memory_maintenance_v2', strict: true, schema: request.schema } } });
+    }
+    decode(envelope, fingerprintKey) { return decodeResponsesEnvelope(envelope, fingerprintKey); }
+}
+export function createOpenAIResponsesMemoryModel(options) { return new OpenAIResponsesMemoryModel(options); }
+//# sourceMappingURL=openai-responses-adapter.js.map

package/dist/memory-manager/openai/openai-responses-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-adapter.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/openai-responses-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAA0B,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAwB,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,OAAO,0BAA2B,SAAQ,qBAAqB;IAC1D,gBAAgB,CAA8B;IACvD,YAAY,OAA0C,IAAI,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAClK,SAAS,CAAC,OAA6B;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAC,KAAK,EAAC,IAAI,CAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,SAAS,EAAC,EAAC,MAAM,EAAC,IAAI,CAAC,gBAAgB,EAAC,EAAC,CAAC,EAAC,iBAAiB,EAAC,IAAI,CAAC,eAAe,EAAC,KAAK,EAAC,CAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,YAAY,EAAC,IAAI,EAAC,OAAO,CAAC,MAAM,EAAC,CAAC,EAAC,EAAC,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,YAAY,EAAC,IAAI,EAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,IAAI,EAAC,EAAC,MAAM,EAAC,EAAC,IAAI,EAAC,aAAa,EAAC,IAAI,EAAC,OAAO,CAAC,UAAU,IAAI,uBAAuB,EAAC,MAAM,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,CAAC,MAAM,EAAC,EAAC,EAAC,CAAC,CAAC;IAChd,CAAC;IACS,MAAM,CAAC,QAAiB,EAAE,cAAsB,IAAuB,OAAO,uBAAuB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7I;AACD,MAAM,UAAU,gCAAgC,CAAC,OAA0C,IAAgC,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/memory-manager/openai/options.d.ts

@@ -0,0 +1,14 @@
+export type RemoteApi = 'responses' | 'chat_completions';
+export declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+export type ReasoningEffort = typeof REASONING_EFFORTS[number];
+export interface RemoteTuning {
+    maxOutputTokens?: number;
+    reasoningEffort?: ReasoningEffort;
+    thinking?: {
+        type: 'enabled' | 'disabled';
+    };
+    enableThinking?: boolean;
+}
+/** Allowlisted knobs only. Choosing an API never silently drops another API's options. */
+export declare function validateRemoteTuning(value: RemoteTuning, api: RemoteApi): RemoteTuning;
+//# sourceMappingURL=options.d.ts.map

package/dist/memory-manager/openai/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/openai/options.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,kBAAkB,CAAC;AACzD,eAAO,MAAM,iBAAiB,uEAAkE,CAAC;AACjG,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,WAAW,YAAY;IAAG,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAC,IAAI,EAAC,SAAS,GAAG,UAAU,CAAA;KAAC,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE;AACjK,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY,CAiBtF"}

package/dist/memory-manager/openai/options.js

@@ -0,0 +1,29 @@
+import { requireInteger } from './remote-http.js';
+export const REASONING_EFFORTS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+/** Allowlisted knobs only. Choosing an API never silently drops another API's options. */
+export function validateRemoteTuning(value, api) {
+    const result = {};
+    if (value.maxOutputTokens !== undefined) {
+        requireInteger('maxOutputTokens', value.maxOutputTokens, 1, 16384);
+        result.maxOutputTokens = value.maxOutputTokens;
+    }
+    if (value.reasoningEffort !== undefined) {
+        if (api !== 'responses' || !REASONING_EFFORTS.includes(value.reasoningEffort))
+            throw new TypeError('reasoningEffort requires Responses and a supported effort enum');
+        result.reasoningEffort = value.reasoningEffort;
+    }
+    if (value.thinking !== undefined) {
+        if (api !== 'chat_completions' || !value.thinking || typeof value.thinking !== 'object' || Object.keys(value.thinking).length !== 1 || !['enabled', 'disabled'].includes(value.thinking.type))
+            throw new TypeError('thinking requires Chat and {type: enabled|disabled}');
+        result.thinking = { type: value.thinking.type };
+    }
+    if (value.enableThinking !== undefined) {
+        if (api !== 'chat_completions' || typeof value.enableThinking !== 'boolean')
+            throw new TypeError('enableThinking requires Chat and a boolean');
+        if (value.thinking !== undefined)
+            throw new TypeError('thinking and enableThinking are mutually exclusive');
+        result.enableThinking = value.enableThinking;
+    }
+    return result;
+}
+//# sourceMappingURL=options.js.map

package/dist/memory-manager/openai/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAC,SAAS,EAAC,KAAK,EAAC,QAAQ,EAAC,MAAM,EAAC,OAAO,EAAC,KAAK,CAAU,CAAC;AAGjG,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,KAAmB,EAAE,GAAc;IACtE,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAAC,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAAC,CAAC;IAChK,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,GAAG,KAAK,WAAW,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;QACrK,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,kBAAkB,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;QACzQ,MAAM,CAAC,QAAQ,GAAG,EAAC,IAAI,EAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,GAAG,KAAK,kBAAkB,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;QAC/I,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC5G,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/memory-manager/openai/remote-http.d.ts

@@ -0,0 +1,33 @@
+import { NetworkClient } from "../network/client.js";
+import type { AnalyzeOptions, ApprovedModelRequest, MemoryModelPort, MemoryModelResult } from '../contracts/model-port.js';
+import { type RemoteDisclosurePolicy } from '../contracts/disclosure.js';
+import { type RetryPolicy } from './retry.js';
+export interface RemoteHttpOptions {
+    network?: NetworkClient;
+    apiKey: string;
+    model: string;
+    disclosurePolicy: RemoteDisclosurePolicy;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    maxOutputTokens?: number;
+    maxResponseBytes?: number;
+    fingerprintKey?: string;
+    sleeper?: (ms: number, signal?: AbortSignal) => Promise<void>;
+    jitter?: () => number;
+    retry?: Partial<RetryPolicy>;
+}
+/** Shared, bounded transport. Each API has an explicit serializer and fail-closed decoder. */
+export declare abstract class RemoteHttpMemoryModel implements MemoryModelPort {
+    #private;
+    protected readonly model: string;
+    protected readonly maxOutputTokens: number;
+    constructor(options: RemoteHttpOptions, endpoint: 'responses' | 'chat/completions');
+    close(): Promise<void>;
+    protected abstract serialize(request: ApprovedModelRequest): string;
+    protected abstract decode(envelope: unknown, fingerprintKey: string): MemoryModelResult;
+    serializedRequestBytes(request: ApprovedModelRequest): number;
+    analyze(request: ApprovedModelRequest, options: AnalyzeOptions): Promise<MemoryModelResult>;
+}
+export declare function requireInteger(name: string, value: number, min: number, max: number): void;
+export declare function normalizeOpenAICompatibleBaseUrl(value: string): string;
+//# sourceMappingURL=remote-http.d.ts.map

package/dist/memory-manager/openai/remote-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-http.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/openai/remote-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,sBAAsB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG3H,OAAO,EAA4B,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAInG,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,sBAAsB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACrK,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7I;AACD,8FAA8F;AAC9F,8BAAsB,qBAAsB,YAAW,eAAe;;IACpE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAMjE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,GAAG,kBAAkB;IAclF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IACnE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB;IACvF,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IACvD,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0DlG;AAyBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAiJ;AAC5O,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtE"}

package/dist/memory-manager/openai/remote-http.js

@@ -0,0 +1,207 @@
+import { NetworkClient, networkFailure } from "../network/client.js";
+import { randomBytes } from 'node:crypto';
+import { MemoryModelError } from '../contracts/errors.js';
+import { validateDisclosurePolicy } from '../contracts/disclosure.js';
+import { externalPreflight } from '../../core/safety/external-preflight.js';
+import { readBoundedBody } from './bounded-body.js';
+import { abortable, cancelBody } from './abort.js';
+import { defaultRetryPolicy, retryDelay } from './retry.js';
+/** Shared, bounded transport. Each API has an explicit serializer and fail-closed decoder. */
+export class RemoteHttpMemoryModel {
+    model;
+    maxOutputTokens;
+    #network;
+    #abort = new AbortController();
+    #closing;
+    #apiKey;
+    #endpoint;
+    #policy;
+    #fetch;
+    #maxResponseBytes;
+    #fingerprintKey;
+    #sleeper;
+    #jitter;
+    #retry;
+    constructor(options, endpoint) {
+        if (!options.apiKey || !options.model)
+            throw new TypeError('apiKey and model are required');
+        validateDisclosurePolicy(options.disclosurePolicy);
+        const retry = { ...defaultRetryPolicy, ...options.retry };
+        this.maxOutputTokens = options.maxOutputTokens ?? 4096;
+        this.#maxResponseBytes = options.maxResponseBytes ?? 1_048_576;
+        requireInteger('maxOutputTokens', this.maxOutputTokens, 1, 16384);
+        requireInteger('maxResponseBytes', this.#maxResponseBytes, 1, 4 * 1024 * 1024);
+        requireInteger('retry.maxRetries', retry.maxRetries, 0, 2);
+        requireInteger('retry.baseDelayMs', retry.baseDelayMs, 0, 30000);
+        requireInteger('retry.maxDelayMs', retry.maxDelayMs, 1, 30000);
+        if (retry.baseDelayMs > retry.maxDelayMs)
+            throw new TypeError('retry.baseDelayMs cannot exceed retry.maxDelayMs');
+        this.#apiKey = options.apiKey;
+        this.model = options.model;
+        this.#endpoint = `${normalizeOpenAICompatibleBaseUrl(options.baseUrl ?? 'https://api.openai.com/v1')}/${endpoint}`;
+        this.#policy = Object.freeze({ ...options.disclosurePolicy, allowedScopes: Object.freeze([...options.disclosurePolicy.allowedScopes]), allowedProvenance: Object.freeze([...options.disclosurePolicy.allowedProvenance]) });
+        if (options.fetch && options.network)
+            throw new TypeError("fetch and network are mutually exclusive");
+        this.#network = options.network;
+        this.#fetch = options.fetch ?? options.network?.fetch ?? fetch;
+        this.#fingerprintKey = options.fingerprintKey ?? randomBytes(32).toString('hex');
+        this.#sleeper = options.sleeper ?? sleep;
+        this.#jitter = options.jitter ?? Math.random;
+        this.#retry = retry;
+    }
+    close() {
+        this.#abort.abort();
+        return this.#closing ??= this.#network?.close() ?? Promise.resolve();
+    }
+    serializedRequestBytes(request) { return Buffer.byteLength(this.serialize(request), 'utf8'); }
+    async analyze(request, options) {
+        options.onDiagnosticContext?.({ stage: 'request' });
+        externalPreflight(request.projection, this.#policy);
+        if (!/^[A-Za-z0-9_-]{1,64}$/u.test(request.schemaName ?? 'memory_maintenance_v2'))
+            throw new TypeError('schemaName must be a safe JSON Schema name');
+        const bodyText = this.serialize(request);
+        externalPreflight(JSON.parse(bodyText), this.#policy, Buffer.byteLength(bodyText, 'utf8'));
+        if (!Number.isFinite(options.deadlineMs) || options.deadlineMs <= 0)
+            throw failure('TIMEOUT', 'request', 'timeout', true);
+        const timeout = AbortSignal.timeout(Math.max(1, Math.min(2_147_483_647, Math.ceil(options.deadlineMs))));
+        const signal = AbortSignal.any([this.#abort.signal, timeout, ...(options.signal ? [options.signal] : [])]);
+        const deadline = Date.now() + options.deadlineMs;
+        const terminated = (stage, httpStatus) => failure(signal.reason === timeout.reason && timeout.aborted ? 'TIMEOUT' : 'CANCELLED', stage, signal.reason === timeout.reason && timeout.aborted ? 'timeout' : 'cancelled', signal.reason === timeout.reason && timeout.aborted, httpStatus);
+        for (let attempt = 0;; attempt++) {
+            if (signal.aborted)
+                throw terminated('request');
+            options.onDiagnosticContext?.({ stage: 'request' });
+            let response;
+            try {
+                const pending = this.#fetch(this.#endpoint, { method: 'POST', signal, headers: { authorization: `Bearer ${this.#apiKey}`, 'content-type': 'application/json' }, body: bodyText });
+                void pending.then(late => { if (signal.aborted)
+                    cancelBody(late.body); }, () => { });
+                response = await abortable(pending, signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw terminated('request');
+                const mapped = error instanceof MemoryModelError ? error : networkFailure(error, false);
+                if (mapped.retryable && attempt < this.#retry.maxRetries) {
+                    await this.#wait(attempt, null, deadline, signal, terminated);
+                    continue;
+                }
+                throw mapped;
+            }
+            options.onDiagnosticContext?.({ stage: response.ok ? 'response_body' : 'http', httpStatus: response.status });
+            if (!response.ok) {
+                const diagnostic = await httpDiagnostic(response, signal);
+                const code = response.status === 401 || response.status === 403 ? 'AUTHENTICATION' : response.status === 429 ? 'RATE_LIMITED' : response.status >= 500 ? 'UNAVAILABLE' : 'INVALID_RESPONSE';
+                if (diagnostic.retryable && attempt < this.#retry.maxRetries && !signal.aborted) {
+                    await this.#wait(attempt, response.headers.get('retry-after'), deadline, signal, terminated, response.status);
+                    continue;
+                }
+                throw new MemoryModelError(code, 'Provider request failed', diagnostic.retryable, diagnostic);
+            }
+            let text;
+            try {
+                text = await readBoundedBody(response, this.#maxResponseBytes, signal);
+            }
+            catch (error) {
+                if (signal.aborted)
+                    throw terminated('response_body', response.status);
+                if (error instanceof MemoryModelError && error.diagnostic)
+                    throw new MemoryModelError(error.code, error.message, error.retryable, { ...error.diagnostic, httpStatus: response.status });
+                if (isConnectionFailure(error)) {
+                    const mapped = networkFailure(error, false);
+                    throw new MemoryModelError(mapped.code, mapped.message, mapped.retryable, { ...mapped.diagnostic, stage: 'response_body', httpStatus: response.status });
+                }
+                throw failure('INVALID_RESPONSE', 'response_body', 'body_read_failed', false, response.status);
+            }
+            if (signal.aborted)
+                throw terminated('response_body', response.status);
+            options.onDiagnosticContext?.({ stage: 'response_envelope', httpStatus: response.status });
+            let envelope;
+            try {
+                envelope = JSON.parse(text);
+            }
+            catch {
+                throw failure('INVALID_RESPONSE', 'response_envelope', 'invalid_json', false, response.status);
+            }
+            try {
+                return this.decode(envelope, this.#fingerprintKey);
+            }
+            catch (error) {
+                if (error instanceof MemoryModelError && error.diagnostic)
+                    throw new MemoryModelError(error.code, error.message, error.retryable, { ...error.diagnostic, httpStatus: response.status });
+                throw failure('INVALID_RESPONSE', 'response_envelope', 'invalid_envelope', false, response.status);
+            }
+        }
+    }
+    async #wait(attempt, retryAfter, deadline, signal, terminated, httpStatus) {
+        if (signal.aborted)
+            throw terminated('request', httpStatus);
+        const delay = retryDelay(attempt, retryAfter, Date.now(), this.#jitter, this.#retry);
+        if (Date.now() + delay >= deadline)
+            throw failure('TIMEOUT', 'request', 'timeout', true, httpStatus);
+        try {
+            await abortable(this.#sleeper(delay, signal), signal);
+        }
+        catch {
+            if (signal.aborted)
+                throw terminated('request', httpStatus);
+            throw failure('UNAVAILABLE', 'request', 'network_error', true, httpStatus);
+        }
+    }
+}
+function failure(code, stage, reason, retryable, httpStatus) {
+    return new MemoryModelError(code, `Model failure: ${reason}`, retryable, { stage, reason, retryable, ...(httpStatus === undefined ? {} : { httpStatus }) });
+}
+async function httpDiagnostic(response, signal) {
+    const status = response.status;
+    let reason = status === 401 || status === 403 ? 'authentication' : status === 429 ? 'rate_limited' : status >= 500 ? 'provider_unavailable' : 'request_rejected';
+    // Error text is transient and bounded in both bytes and time. Match codes exactly, never persist messages.
+    try {
+        const text = await readBoundedBody(response, 16384, AbortSignal.any([signal, AbortSignal.timeout(2000)]));
+        const body = JSON.parse(text);
+        const known = { invalid_json_schema: 'invalid_schema', model_not_found: 'model_not_found', unsupported_parameter: 'unsupported_parameter', context_length_exceeded: 'context_length_exceeded', insufficient_quota: 'insufficient_quota', invalid_api_key: 'authentication' };
+        const code = body?.error?.code;
+        if (typeof code === 'string' && Object.hasOwn(known, code))
+            reason = known[code];
+        else if (code === 'invalid_request_error' && typeof body.error?.message === 'string' && body.error.message.startsWith('Invalid json schema:'))
+            reason = 'invalid_schema';
+    }
+    catch { /* HTTP status survives unreadable, oversized, malformed or stalled error bodies. */ }
+    return { stage: 'http', reason, httpStatus: status, retryable: status === 429 || status >= 500 };
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => { clearTimeout(timer); reject(signal?.reason); };
+        const timer = setTimeout(() => { signal?.removeEventListener('abort', abort); resolve(); }, ms);
+        signal?.addEventListener('abort', abort, { once: true });
+        if (signal?.aborted)
+            abort();
+    });
+}
+export function requireInteger(name, value, min, max) { if (!Number.isSafeInteger(value) || value < min || value > max)
+    throw new TypeError(`${name} must be an integer between ${min} and ${max}`); }
+export function normalizeOpenAICompatibleBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new TypeError('baseUrl must be an absolute HTTP(S) URL');
+    }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:')
+        throw new TypeError('baseUrl must use HTTP or HTTPS');
+    if (url.username || url.password || url.search || url.hash)
+        throw new TypeError('baseUrl must not contain credentials, query, or fragment');
+    url.pathname = url.pathname.replace(/\/+$/u, '');
+    if (/\/(responses|chat\/completions)$/u.test(url.pathname))
+        throw new TypeError('baseUrl must be the API root, not a completion endpoint');
+    return url.toString().replace(/\/$/u, '');
+}
+/** Recognized transport codes only; malformed content and arbitrary exception text stay untrusted. */
+function isConnectionFailure(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const e = error;
+    return [e.code, e.cause?.code].some(code => typeof code === 'string' && ['ECONNRESET', 'ETIMEDOUT', 'UND_ERR_SOCKET', 'UND_ERR_BODY_TIMEOUT'].includes(code));
+}
+//# sourceMappingURL=remote-http.js.map

package/dist/memory-manager/openai/remote-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-http.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/remote-http.ts"],"names":[],"mappings":"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"}

package/dist/memory-manager/openai/response-decoder.d.ts

@@ -0,0 +1,3 @@
+import type { MemoryModelResult } from "../contracts/model-port.js";
+export declare function decodeResponsesEnvelope(value: unknown, fingerprintKey: string): MemoryModelResult;
+//# sourceMappingURL=response-decoder.d.ts.map

package/dist/memory-manager/openai/response-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-decoder.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/openai/response-decoder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,4BAA4B,CAAC;AAIhF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB,CAsBjG"}

package/dist/memory-manager/openai/response-decoder.js

@@ -0,0 +1,57 @@
+import { createHmac } from "node:crypto";
+import { MemoryModelError } from "../contracts/errors.js";
+export function decodeResponsesEnvelope(value, fingerprintKey) {
+    const root = record(value);
+    if (root.status === "incomplete") {
+        const details = root.incomplete_details;
+        invalid(details && typeof details === 'object' && 'reason' in details && details.reason === 'max_output_tokens' ? 'output_truncated' : 'incomplete_output');
+    }
+    if (root.status !== "completed" || (root.incomplete_details !== null && root.incomplete_details !== undefined) || (root.error !== null && root.error !== undefined) || !Array.isArray(root.output))
+        invalid();
+    const messages = [];
+    for (const item of root.output) {
+        const output = record(item);
+        if (output.type === "reasoning")
+            continue;
+        if (output.type !== "message")
+            invalid(typeof output.type === "string" && /(?:call|tool)/u.test(output.type) ? "tool_call" : "invalid_envelope");
+        messages.push(output);
+    }
+    if (messages.length !== 1)
+        invalid();
+    const message = messages[0];
+    if (message.status !== "completed" || message.role !== "assistant" || !Array.isArray(message.content) || message.content.length !== 1)
+        invalid();
+    const content = record(message.content[0]);
+    const usage = parseUsage(root.usage);
+    if (content.type === "refusal" && typeof content.refusal === "string")
+        return { kind: "refusal", category: "provider_refusal", fingerprint: createHmac("sha256", fingerprintKey).update(content.refusal, "utf8").digest("hex"), usage };
+    if (content.type !== "output_text" || typeof content.text !== "string")
+        invalid();
+    let body;
+    try {
+        body = JSON.parse(content.text);
+    }
+    catch {
+        invalid("invalid_json");
+    }
+    return { kind: "output", body, usage };
+}
+function parseUsage(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    const usage = value;
+    const out = {};
+    if (finite(usage.input_tokens))
+        out.inputTokens = usage.input_tokens;
+    if (finite(usage.output_tokens))
+        out.outputTokens = usage.output_tokens;
+    if (finite(usage.total_tokens))
+        out.totalTokens = usage.total_tokens;
+    return out;
+}
+function finite(value) { return typeof value === "number" && Number.isFinite(value) && value >= 0; }
+function record(value) { if (!value || typeof value !== "object" || Array.isArray(value))
+    invalid(); return value; }
+function invalid(reason = "invalid_envelope") { throw new MemoryModelError("INVALID_RESPONSE", "Provider returned an invalid Responses envelope", false, { stage: reason === "invalid_json" ? "model_output" : "response_envelope", reason, retryable: false }); }
+//# sourceMappingURL=response-decoder.js.map

package/dist/memory-manager/openai/response-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-decoder.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/response-decoder.ts"],"names":[],"mappings":"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"}

package/dist/memory-manager/openai/retry.d.ts

@@ -0,0 +1,8 @@
+export interface RetryPolicy {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+export declare const defaultRetryPolicy: RetryPolicy;
+export declare function retryDelay(attempt: number, retryAfter: string | null, nowMs: number, jitter: () => number, policy: RetryPolicy): number;
+//# sourceMappingURL=retry.d.ts.map

package/dist/memory-manager/openai/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/openai/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAC5F,eAAO,MAAM,kBAAkB,EAAE,WAAoE,CAAC;AACtG,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAMvI"}

package/dist/memory-manager/openai/retry.js

@@ -0,0 +1,18 @@
+export const defaultRetryPolicy = { maxRetries: 2, baseDelayMs: 200, maxDelayMs: 5_000 };
+export function retryDelay(attempt, retryAfter, nowMs, jitter, policy) {
+    let requested = null;
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (Number.isFinite(seconds) && seconds >= 0)
+            requested = seconds * 1000;
+        else {
+            const date = Date.parse(retryAfter);
+            if (Number.isFinite(date))
+                requested = Math.max(0, date - nowMs);
+        }
+    }
+    const exponential = Math.min(policy.maxDelayMs, policy.baseDelayMs * 2 ** attempt);
+    const delay = requested ?? exponential * (0.5 + Math.max(0, Math.min(1, jitter())) * 0.5);
+    return Math.min(policy.maxDelayMs, Math.max(0, Math.round(delay)));
+}
+//# sourceMappingURL=retry.js.map

package/dist/memory-manager/openai/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/memory-manager/openai/retry.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,kBAAkB,GAAgB,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACtG,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,UAAyB,EAAE,KAAa,EAAE,MAAoB,EAAE,MAAmB;IAC7H,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,UAAU,EAAE,CAAC;QAAC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;YAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;aAAM,CAAC;YAAC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;QAAC,CAAC;IAAC,CAAC;IACjP,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,SAAS,IAAI,WAAW,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/pi-extension/extraction-runtime.d.ts

@@ -0,0 +1,51 @@
+import { SessionIngress, type SessionCacheOptions } from '../v2/session.js';
+export declare const piProcessInstance: string;
+import type { RuntimeStore } from "../v2/runtime.js";
+export interface SessionUserEntry {
+    sequence?: number;
+    id: string;
+    text: string;
+    timestamp: number;
+}
+export interface PiWriter {
+    store: RuntimeStore;
+    run(options?: {
+        force?: boolean;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    close(): void | Promise<void>;
+}
+/** Host lifecycle adapter. Delivery, rather than successful assistant completion, is evidence. */
+export declare class PiCaptureRuntime {
+    #private;
+    readonly ingress: SessionIngress;
+    constructor(writer: PiWriter, options?: SessionCacheOptions);
+    start(sessionId: string, entries: SessionUserEntry[]): void;
+    input(input: {
+        sessionId: string;
+        text: string;
+        source: string;
+        scope: string;
+        streamingBehavior?: "steer" | "followUp";
+        parentEntryId?: string | null;
+        hasUnsupportedContent?: boolean;
+    }): void;
+    delivered(sessionId: string, text: string, timestamp: number, hasUnsupportedContent?: boolean): void;
+    bind(sessionId: string, entries: SessionUserEntry[]): void;
+    cancelInputs(sessionId: string): void;
+    busy(): void;
+    settled(sessionId: string, entries: SessionUserEntry[], state?: 'settled' | 'interrupted'): void;
+    key(sessionId: string): string;
+    context(sessionId: string, entries: readonly {
+        sequence?: number;
+        id: string;
+        role: 'assistant' | 'tool';
+        text: string;
+        timestamp: number;
+    }[]): void;
+    end(sessionId: string): void;
+    flush(): void;
+    check(): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=extraction-runtime.d.ts.map

package/dist/pi-extension/extraction-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-runtime.d.ts","sourceRoot":"","sources":["../../src/pi-extension/extraction-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,eAAO,MAAM,iBAAiB,QAAyD,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,EAAC,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AACnG,MAAM,WAAW,QAAQ;IAAG,KAAK,EAAE,YAAY,CAAC;IAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;AAC1J,kGAAkG;AAClG,qBAAa,gBAAgB;;IAE3B,QAAQ,CAAC,OAAO,EAAC,cAAc,CAAC;gBAQpB,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAC,mBAAwB;IAM9D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAC3D,KAAK,CAAC,KAAK,EAAE;QAAC,SAAS,EAAC,MAAM,CAAC;QAAA,IAAI,EAAC,MAAM,CAAC;QAAA,MAAM,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAC;QAAA,iBAAiB,CAAC,EAAC,OAAO,GAAC,UAAU,CAAC;QAAA,aAAa,CAAC,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,qBAAqB,CAAC,EAAC,OAAO,CAAA;KAAC,GAAG,IAAI;IAC7K,SAAS,CAAC,SAAS,EAAC,MAAM,EAAC,IAAI,EAAC,MAAM,EAAC,SAAS,EAAC,MAAM,EAAC,qBAAqB,UAAM,GAAG,IAAI;IAC1F,IAAI,CAAC,SAAS,EAAC,MAAM,EAAC,OAAO,EAAC,gBAAgB,EAAE,GAAG,IAAI;IAIvD,YAAY,CAAC,SAAS,EAAC,MAAM,GAAG,IAAI;IACpC,IAAI,IAAI,IAAI;IACZ,OAAO,CAAC,SAAS,EAAC,MAAM,EAAC,OAAO,EAAC,gBAAgB,EAAE,EAAC,KAAK,GAAC,SAAS,GAAC,aAAuB,GAAG,IAAI;IAClG,GAAG,CAAC,SAAS,EAAC,MAAM,GAAE,MAAM;IAC5B,OAAO,CAAC,SAAS,EAAC,MAAM,EAAC,OAAO,EAAC,SAAS;QAAC,QAAQ,CAAC,EAAC,MAAM,CAAC;QAAA,EAAE,EAAC,MAAM,CAAC;QAAA,IAAI,EAAC,WAAW,GAAC,MAAM,CAAC;QAAA,IAAI,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC,EAAE,GAAE,IAAI;IAOnI,GAAG,CAAC,SAAS,EAAC,MAAM,GAAE,IAAI;IAC1B,KAAK,IAAI,IAAI;IACb,KAAK,IAAI,IAAI;IAQb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAU1B"}