@spine-event-engine/server 2.0.0-snapshot.24 → 2.0.0-snapshot.25

package/dist/agent/agent-interaction-audit.js

@@ -1,114 +0,0 @@
-/*
- * Copyright 2026, CodeMatters. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
- * in compliance with the License. You may obtain a copy of the License at
- *
- * https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under the License
- * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
- * or implied. See the License for the specific language governing permissions and limitations under
- * the License.
- */
-import { create } from "@bufbuild/protobuf";
-import {} from "@spine-event-engine/core";
-import {} from "@spine-event-engine/proto";
-import { AgentHistoryEntrySchema, AiModelKind, } from "@spine-event-engine/proto/agent";
-import {} from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import { AgentExecutionSizes } from "@spine-event-engine/storage/provider";
-import { AgentExecutionSession } from "./agent-execution-session.js";
-import { AgentInteractionEvents } from "./agent-interaction-events.js";
-/**
- * Saves one original Agent interaction Event and posts it to the System Context.
- */
-export class AgentInteractionAudit {
-    session;
-    accepted;
-    stateSchema;
-    metadata;
-    onRegisterSchema;
-    onPublish;
-    /**
-     * Binds interaction evidence to one accepted Agent invocation.
-     *
-     * @param session Fenced execution journal and history writer.
-     * @param accepted Original accepted signal and recipient.
-     * @param stateSchema Generated Agent state descriptor.
-     * @param metadata Canonical signal metadata service.
-     * @param onRegisterSchema Registers a System event payload descriptor.
-     * @param onPublish Persists the System Context copy of an original Event.
-     */
-    constructor(session, accepted, stateSchema, metadata, onRegisterSchema, onPublish) {
-        this.session = session;
-        this.accepted = accepted;
-        this.stateSchema = stateSchema;
-        this.metadata = metadata;
-        this.onRegisterSchema = onRegisterSchema;
-        this.onPublish = onPublish;
-    }
-    /**
-     * Creates a named call reference with its model fixed at invocation start.
-     *
-     * @param operation Saved named operation.
-     * @param kind Selected generation or decision kind.
-     * @returns Reference with the accepted Agent, source, and model identities.
-     */
-    reference(operation, kind) {
-        const selected = this.session.record().started?.models.find((item) => item.kind === kind);
-        if (selected === undefined)
-            throw new Error("Agent audit requires a saved selected model.");
-        return AgentInteractionEvents.operationRef(this.accepted, operation, this.stateSchema, selected);
-    }
-    /**
-     * Calculates an original typed System row size with this invocation's full scope.
-     *
-     * @typeParam Schema Generated System event payload descriptor.
-     * @param schema Payload descriptor.
-     * @param payload Matching typed event payload.
-     * @returns Encoded provider history-row size in bytes.
-     */
-    historyBytes(schema, payload) {
-        const scope = this.accepted.key?.scope;
-        const id = this.accepted.recipientId;
-        if (scope === undefined || id === undefined)
-            throw new Error("Agent audit sizing requires accepted scope and recipient.");
-        const event = AgentInteractionEvents.envelope(this.accepted, this.metadata, id, schema, payload);
-        const occurredAt = event.context?.timestamp;
-        if (occurredAt === undefined)
-            throw new Error("Agent audit sizing requires Time.");
-        return AgentExecutionSizes.history(scope, create(AgentHistoryEntrySchema, {
-            occurredAt,
-            item: { case: "systemEvent", value: event },
-        }));
-    }
-    /**
-     * Writes the original Event with its journal change before publication.
-     *
-     * @typeParam Schema Generated System event payload descriptor.
-     * @param schema Payload descriptor.
-     * @param payload Matching typed event payload.
-     * @param change Journal mutation guarded by the current claim.
-     * @param history Conversation rows included in the same fenced mutation.
-     * @returns When the journal and System Context publication both complete.
-     */
-    async save(schema, payload, change, history = []) {
-        const id = this.accepted.recipientId;
-        if (id === undefined)
-            throw new Error("Agent audit requires a typed recipient.");
-        const event = AgentInteractionEvents.envelope(this.accepted, this.metadata, id, schema, payload);
-        const occurredAt = event.context?.timestamp;
-        if (occurredAt === undefined)
-            throw new Error("Agent audit Event requires Time.");
-        this.onRegisterSchema(schema);
-        await this.session.update(change, [
-            ...history,
-            create(AgentHistoryEntrySchema, {
-                occurredAt,
-                item: { case: "systemEvent", value: event },
-            }),
-        ]);
-        await this.onPublish(event);
-    }
-}
-//# sourceMappingURL=agent-interaction-audit.js.map

package/dist/agent/agent-interaction-audit.js.map

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

package/dist/agent/agent-interaction-events.d.ts

@@ -1,40 +0,0 @@
-import { type MessageShape } from "@bufbuild/protobuf";
-import { type Any } from "@bufbuild/protobuf/wkt";
-import { type MessageSchema } from "@spine-event-engine/core";
-import { type Event } from "@spine-event-engine/proto";
-import { type AgentOperationRef } from "@spine-event-engine/proto/agent";
-import { type AgentAcceptedInvocation, type AgentNamedOperation, type AgentSelectedModel } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import type { SignalMetadata } from "../runtime/signal-metadata.js";
-/**
- * Creates references and typed envelopes for Agent interaction events.
- */
-interface AgentInteractionEventFactory {
-    /**
-     * Creates a reference to accepted work and its selected model.
-     *
-     * @param accepted Durable accepted invocation.
-     * @param operation Named model operation.
-     * @param stateSchema Generated Agent state descriptor.
-     * @param selected Selected deployment for this operation kind.
-     * @returns Complete operation reference.
-     */
-    operationRef(accepted: AgentAcceptedInvocation, operation: AgentNamedOperation, stateSchema: MessageSchema, selected: AgentSelectedModel): AgentOperationRef;
-    /**
-     * Wraps a typed System-event payload with the original causal context.
-     *
-     * @typeParam Schema Generated System-event descriptor.
-     * @param accepted Durable source Command, Event, or rejection.
-     * @param metadata Spine ID, Time, and origin metadata provider.
-     * @param agentId Original typed Agent identifier.
-     * @param schema Generated System-event descriptor.
-     * @param payload Matching typed System-event message.
-     * @returns Fresh Event envelope.
-     */
-    envelope<Schema extends MessageSchema>(accepted: AgentAcceptedInvocation, metadata: SignalMetadata, agentId: Any, schema: Schema, payload: MessageShape<Schema>): Event;
-}
-/**
- * Creates immutable System-event facts from accepted Agent work.
- */
-export declare const AgentInteractionEvents: AgentInteractionEventFactory;
-export {};
-//# sourceMappingURL=agent-interaction-events.d.ts.map

package/dist/agent/agent-interaction-events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-interaction-events.d.ts","sourceRoot":"","sources":["../../src/agent/agent-interaction-events.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,+EAA+E,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAuCpE;;GAEG;AACH,UAAU,4BAA4B;IACpC;;;;;;;;OAQG;IACH,YAAY,CACV,QAAQ,EAAE,uBAAuB,EACjC,SAAS,EAAE,mBAAmB,EAC9B,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,iBAAiB,CAAC;IAErB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,SAAS,aAAa,EACnC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,GAC5B,KAAK,CAAC;CACV;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,4BAkFnC,CAAC"}

package/dist/agent/agent-interaction-events.js

@@ -1,129 +0,0 @@
-/*
- * Copyright 2026, CodeMatters. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
- * in compliance with the License. You may obtain a copy of the License at
- *
- * https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under the License
- * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
- * or implied. See the License for the specific language governing permissions and limitations under
- * the License.
- */
-import { create, equals } from "@bufbuild/protobuf";
-import { AnySchema } from "@bufbuild/protobuf/wkt";
-import { AnyMessages, TypeUrls, Validate } from "@spine-event-engine/core";
-import { CommandIdSchema, EventIdSchema, EventSchema, MessageIdSchema, } from "@spine-event-engine/proto";
-import { AgentOperationRefSchema, AiModelKind, } from "@spine-event-engine/proto/agent";
-import {} from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-/**
- * Requires the original identifier's concrete Protobuf type URL.
- *
- * @param value Candidate typed identifier.
- * @param field Diagnostic field name.
- * @returns Candidate after its type URL is checked.
- */
-const typedId = (value, field) => {
-    if (!value?.typeUrl.trim())
-        throw new TypeError(`Agent interaction requires typed ${field}.`);
-    return value;
-};
-/**
- * Copies the original signal ID and domain payload type from accepted work.
- *
- * @param accepted Original accepted Command, Event, or rejection.
- * @returns Canonical source MessageId.
- */
-const sourceRef = (accepted) => {
-    const signal = accepted.signal;
-    if (signal.case === "command") {
-        const id = signal.value.id;
-        if (!id?.uuid.trim())
-            throw new TypeError("Agent interaction requires source Command ID.");
-        const typeUrl = signal.value.message?.typeUrl;
-        if (!typeUrl?.trim())
-            throw new TypeError("Agent interaction requires source payload type.");
-        return create(MessageIdSchema, { id: AnyMessages.pack(CommandIdSchema, id), typeUrl });
-    }
-    if (signal.case === "event") {
-        const id = signal.value.id;
-        if (!id?.value.trim())
-            throw new TypeError("Agent interaction requires source Event ID.");
-        const typeUrl = signal.value.message?.typeUrl;
-        if (!typeUrl?.trim())
-            throw new TypeError("Agent interaction requires source payload type.");
-        return create(MessageIdSchema, { id: AnyMessages.pack(EventIdSchema, id), typeUrl });
-    }
-    throw new TypeError("Agent interaction requires a source signal.");
-};
-/**
- * Creates immutable System-event facts from accepted Agent work.
- */
-export const AgentInteractionEvents = Object.freeze({
-    /**
-     * Correlates a named operation with its typed Agent, source signal, and selected model.
-     *
-     * @param accepted Durable accepted invocation.
-     * @param operation Named model operation.
-     * @param stateSchema Generated Agent state descriptor.
-     * @param selected Selected deployment for this operation kind.
-     * @returns Complete operation reference.
-     */
-    operationRef(accepted, operation, stateSchema, selected) {
-        const stateType = accepted.key?.scope?.stateType;
-        if (stateType !== stateSchema.typeName)
-            throw new TypeError("Agent interaction state type does not match accepted work.");
-        const agentId = typedId(accepted.recipientId, "Agent ID");
-        if (!operation.operation?.value.trim() || !operation.conversation?.value.trim())
-            throw new TypeError("Agent interaction requires operation and conversation IDs.");
-        if (!selected.model?.name?.value.trim() ||
-            !selected.model.revision?.value.trim() ||
-            (selected.kind !== AiModelKind.GENERATION && selected.kind !== AiModelKind.DECISION))
-            throw new TypeError("Agent interaction requires a selected model and kind.");
-        const result = create(AgentOperationRefSchema, {
-            operation: operation.operation,
-            agent: create(MessageIdSchema, {
-                id: agentId,
-                typeUrl: TypeUrls.derive(stateSchema),
-            }),
-            sourceSignal: sourceRef(accepted),
-            model: selected.model,
-            kind: selected.kind,
-            conversation: operation.conversation,
-        });
-        return Validate.check(AgentOperationRefSchema, result);
-    },
-    /**
-     * Wraps one typed System-event payload with original causality and Agent producer identity.
-     *
-     * @typeParam Schema Generated System-event descriptor.
-     * @param accepted Durable source Command, Event, or rejection.
-     * @param metadata Spine ID, Time, and origin metadata provider.
-     * @param agentId Original typed Agent identifier.
-     * @param schema Generated System-event descriptor.
-     * @param payload Matching typed System-event message.
-     * @returns Fresh Event envelope without mutating accepted work.
-     */
-    envelope(accepted, metadata, agentId, schema, payload) {
-        const producer = typedId(agentId, "Agent ID");
-        if (!accepted.recipientId || !equals(AnySchema, accepted.recipientId, producer))
-            throw new TypeError("Agent interaction producer differs from accepted recipient.");
-        sourceRef(accepted);
-        const origin = accepted.signal.case === "command"
-            ? metadata.eventFromCommand(accepted.signal.value, {})
-            : accepted.signal.case === "event"
-                ? metadata.eventFromEvent(accepted.signal.value, {})
-                : undefined;
-        if (!origin)
-            throw new TypeError("Agent interaction requires a source signal.");
-        const context = origin.context;
-        context.producerId = producer;
-        return Validate.check(EventSchema, create(EventSchema, {
-            id: origin.id,
-            context,
-            message: AnyMessages.pack(schema, payload),
-        }));
-    },
-});
-//# sourceMappingURL=agent-interaction-events.js.map

package/dist/agent/agent-interaction-events.js.map

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

package/dist/agent/agent-mcp-budget.d.ts

@@ -1,125 +0,0 @@
-import type { AiMcpMessageRequest, AiMcpMessageTicket, AiToolInvocation } from "@spine-event-engine/ai/spi/adapter";
-import { type AgentHistoryEntry, type ToolRequest, type ToolResponse } from "@spine-event-engine/proto/agent";
-import { type AgentExecutionRecord, type AgentExecutionHead, type AgentNamedOperation } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import { type AgentExecutionCapacity } from "@spine-event-engine/storage/provider";
-import type { AgentMcpIntent } from "./agent-mcp-host.js";
-import { AgentInteractionAudit } from "./agent-interaction-audit.js";
-/**
- * Provides the fenced record, capacity, and mutation view used by MCP.
- */
-interface JournalSession {
-    /**
-     * Stops physical work when the execution claim closes.
-     */
-    readonly signal: AbortSignal;
-    /**
-     * Reads the current durable execution record.
-     *
-     * @returns Current durable execution record.
-     */
-    record(): AgentExecutionRecord;
-    /**
-     * Writes one fenced record mutation with optional Agent history rows.
-     *
-     * @param change Record transformation under the claim token.
-     * @param historyEntries Rows included in the provider mutation.
-     * @returns The saved record image.
-     */
-    update(change: (record: AgentExecutionRecord) => AgentExecutionRecord, historyEntries?: readonly AgentHistoryEntry[]): Promise<AgentExecutionRecord>;
-    /**
-     * Reads provider limits for complete encoded rows.
-     *
-     * @returns Provider limits for complete encoded rows.
-     */
-    capacity(): AgentExecutionCapacity;
-    /**
-     * Reads current saved model preferences for the Agent instance.
-     *
-     * @returns Current saved model preferences.
-     */
-    preferences(): Readonly<AgentExecutionHead["preferences"]>;
-}
-/**
- * Charges MCP physical messages to the same fenced invocation ledger as model sends.
- */
-export declare class AgentMcpBudget {
-    #private;
-    private readonly session;
-    private readonly operation;
-    private readonly deadlineEpochMs;
-    private readonly audit;
-    /**
-     * Binds one MCP operation to the shared fenced invocation budget.
-     *
-     * @param session Fenced execution journal.
-     * @param operation Saved named operation.
-     * @param deadlineEpochMs Original operation deadline.
-     * @param audit Paired Agent history and System Event writer.
-     */
-    constructor(session: JournalSession, operation: AgentNamedOperation, deadlineEpochMs: number | undefined, audit: AgentInteractionAudit | undefined);
-    /**
-     * Checks invocation bounds using measured receipts and full unknown credit.
-     *
-     * @param record Current durable invocation.
-     * @param input Proposed physical input bytes.
-     * @param output Proposed physical response allowance.
-     */
-    static checkSharedBytes(record: AgentExecutionRecord, input: number, output: number): void;
-    /**
-     * Returns unspent configured invocation output credit, if configured.
-     *
-     * @param record Durable execution record containing receipts and optional bounds.
-     * @returns Remaining byte credit, or undefined when no total bound was configured.
-     */
-    static remainingOutputCredit(record: AgentExecutionRecord): bigint | undefined;
-    /**
-     * Persists full request bytes and response credit before a physical MCP send.
-     *
-     * @param server Configured MCP server identifier.
-     * @param request Physical protocol message and byte bounds.
-     * @returns Fenced ticket for the one physical send.
-     */
-    reserveMessage(server: string, request: AiMcpMessageRequest): Promise<AiMcpMessageTicket>;
-    /**
-     * Rejects the chunk that crosses persisted full response credit.
-     *
-     * @param ticketId Saved physical-message ticket.
-     * @param bytes Newly decoded response bytes.
-     */
-    onReceived(ticketId: string, bytes: number): void;
-    /**
-     * Persists known receipt; unknown work retains its full original credit.
-     *
-     * @param ticketId Saved physical-message ticket.
-     * @param receivedBytes Complete decoded response size, when known.
-     * @returns When the receipt is persisted.
-     */
-    finishMessage(ticketId: string, receivedBytes?: number): Promise<void>;
-    /**
-     * Persists one authorized proposal and never reissues an uncertain write.
-     *
-     * @param invocation Model proposal and provider call identity.
-     * @param facts Vetted server, tool, arguments, and effect.
-     * @param operationLimit Capability tool-call bound.
-     * @returns Saved or newly allocated tool intent.
-     */
-    journalToolIntent(invocation: AiToolInvocation, facts: Pick<ToolRequest, "server" | "tool" | "argumentsJson" | "effect">, operationLimit: number | undefined): Promise<AgentMcpIntent>;
-    /**
-     * Persists the pre-send boundary; repeating a read may retain this flag.
-     *
-     * @param callId Saved logical tool-call identity.
-     * @returns When the dispatch marker is persisted.
-     */
-    markToolDispatched(callId: string): Promise<void>;
-    /**
-     * Persists a complete tool result and its typed conversation row together.
-     *
-     * @param callId Saved logical tool-call identity.
-     * @param response Bounded tool result.
-     * @param history Typed conversation rows retained with the result.
-     * @returns When the fenced result and history are persisted.
-     */
-    finishTool(callId: string, response: ToolResponse, history: readonly AgentHistoryEntry[]): Promise<void>;
-}
-export {};
-//# sourceMappingURL=agent-mcp-budget.d.ts.map

package/dist/agent/agent-mcp-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-mcp-budget.d.ts","sourceRoot":"","sources":["../../src/agent/agent-mcp-budget.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAeL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,+EAA+E,CAAC;AACvF,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,UAAU,cAAc;IACtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;OAIG;IACH,MAAM,IAAI,oBAAoB,CAAC;IAE/B;;;;;;OAMG;IACH,MAAM,CACJ,MAAM,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,oBAAoB,EAC9D,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,IAAI,sBAAsB,CAAC;IAEnC;;;;OAIG;IACH,WAAW,IAAI,QAAQ,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,qBAAa,cAAc;;IAYvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAZxB;;;;;;;OAOG;gBAEgB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,mBAAmB,EAC9B,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,qBAAqB,GAAG,SAAS;IAG3D;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAuB1F;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS;IAc9E;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiD/F;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWjD;;;;;;OAMG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5E;;;;;;;OAOG;IACG,iBAAiB,CACrB,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,QAAQ,CAAC,EACxE,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,cAAc,CAAC;IAqG1B;;;;;OAKG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvD;;;;;;;OAOG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,OAAO,CAAC,IAAI,CAAC;CA+UjB"}