@letta-ai/letta-code 0.30.2 → 0.30.3

package/dist/types/providers/openai-codex-provider.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ChatGPT OAuth provider management backed by the active provider store.
+ * API mode stores a chatgpt_oauth provider on Letta; local mode stores OAuth
+ * tokens in the local provider auth file and uses a local fetch shim at runtime.
+ */
+import { listProviders, type ProviderOperationOptions, type ProviderResponse } from "./byok-providers";
+import { OPENAI_CODEX_PROVIDER_NAME } from "./openai-codex-constants";
+export { listProviders };
+export { OPENAI_CODEX_PROVIDER_NAME };
+export declare const CHATGPT_OAUTH_PROVIDER_TYPE = "chatgpt_oauth";
+export declare function normalizeChatGPTOAuthProviderName(providerName?: string | null): string;
+/**
+ * ChatGPT OAuth configuration persisted by the active provider store.
+ */
+export interface ChatGPTOAuthConfig {
+    access_token: string;
+    id_token: string;
+    refresh_token?: string;
+    account_id: string;
+    expires_at: number;
+}
+interface EligibilityCheckResult {
+    eligible: boolean;
+    billing_tier: string;
+    reason?: string;
+}
+/**
+ * Get the chatgpt-plus-pro provider if it exists
+ */
+export declare function getOpenAICodexProvider(options?: ProviderOperationOptions, providerName?: string): Promise<ProviderResponse | null>;
+/**
+ * Create a new ChatGPT OAuth provider
+ * OAuth config is JSON-encoded in api_key field for API-mode compatibility.
+ */
+export declare function createOpenAICodexProvider(config: ChatGPTOAuthConfig, options?: ProviderOperationOptions, providerName?: string): Promise<ProviderResponse>;
+/**
+ * Update an existing ChatGPT OAuth provider with new OAuth config
+ * OAuth config is JSON-encoded in api_key field for API-mode compatibility.
+ */
+export declare function updateOpenAICodexProvider(providerId: string, config: ChatGPTOAuthConfig, options?: ProviderOperationOptions): Promise<ProviderResponse>;
+/**
+ * Create or update the ChatGPT OAuth provider
+ * This is the main function called after successful /connect codex
+ *
+ * In API mode the Letta backend will:
+ * 1. Store the OAuth tokens securely
+ * 2. Handle token refresh when needed
+ * 3. Transform requests from OpenAI format to ChatGPT backend format
+ * 4. Add required headers (Authorization, ChatGPT-Account-Id, etc.)
+ * 5. Forward to chatgpt.com/backend-api/codex
+ */
+export declare function createOrUpdateOpenAICodexProvider(config: ChatGPTOAuthConfig, options?: ProviderOperationOptions, providerName?: string): Promise<ProviderResponse>;
+/**
+ * Check if user is eligible for ChatGPT OAuth
+ * Requires Pro or Enterprise billing tier
+ */
+export declare function checkOpenAICodexEligibility(): Promise<EligibilityCheckResult>;
+//# sourceMappingURL=openai-codex-provider.d.ts.map

package/dist/types/providers/openai-codex-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-codex-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGL,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EAEtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAKtC,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,wBAAgB,iCAAiC,CAC/C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAWR;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,MAAmC,GAChD,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAKlC;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,MAAmC,GAChD,OAAO,CAAC,gBAAgB,CAAC,CAW3B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAS3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,MAAmC,GAChD,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CA2BnF"}

package/dist/types/queue/queue-runtime.d.ts

@@ -0,0 +1,172 @@
+import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
+import type { QueueBlockedReason, QueueClearedReason, QueueItemDroppedReason, QueueItemKind, QueueItemSource } from "../types/protocol";
+export type { QueueBlockedReason, QueueClearedReason, QueueItemKind };
+type QueueItemBase = {
+    /** Stable monotonic ID assigned on enqueue. */
+    id: string;
+    /** Optional client-side message correlation ID from submit payloads. */
+    clientMessageId?: string;
+    /** Optional agent scope for listener-mode attribution. */
+    agentId?: string;
+    /** Optional conversation scope for listener-mode attribution. */
+    conversationId?: string;
+    /**
+     * Cloud user id of the human who actually submitted this item,
+     * forwarded from cloud-api on the inbound `input` frame. The
+     * listener echoes this on the outbound createMessage HTTP call
+     * (X-Letta-Acting-User-Id header) so cloud attributes credits +
+     * rate limits to the actual sender — not the user whose API key
+     * spawned the sandbox / desktop runtime.
+     *
+     * Undefined for self-hosted, single-user, or pre-channel-split
+     * flows where cloud doesn't stamp the field.
+     */
+    actingUserId?: string;
+    source: QueueItemSource;
+    enqueuedAt: number;
+};
+export type MessageQueueItem = QueueItemBase & {
+    kind: "message";
+    /** Full multimodal content — string or content-part array. */
+    content: MessageCreate["content"];
+    /**
+     * Never merge this item with other queued messages. Set by request-scoped
+     * producers (e.g. the OpenAI-compat HTTP bridge) where each message must
+     * run as its own turn so its correlated client request can settle.
+     */
+    noCoalesce?: boolean;
+};
+export type TaskNotificationQueueItem = QueueItemBase & {
+    kind: "task_notification";
+    /** XML notification string. */
+    text: string;
+};
+export type ApprovalResultQueueItem = QueueItemBase & {
+    kind: "approval_result";
+    text: string;
+};
+export type OverlayActionQueueItem = QueueItemBase & {
+    kind: "overlay_action";
+    text: string;
+};
+export type CronPromptQueueItem = QueueItemBase & {
+    kind: "cron_prompt";
+    /** XML-wrapped prompt text. */
+    text: string;
+    /** Cron task ID for tracing. */
+    cronTaskId: string;
+};
+export type ModContinueQueueItem = QueueItemBase & {
+    kind: "mod_continue";
+    /** Follow-up text from a mod's turn_end { continue }, sent as a user message. */
+    text: string;
+};
+export type QueueItem = MessageQueueItem | TaskNotificationQueueItem | CronPromptQueueItem | ApprovalResultQueueItem | OverlayActionQueueItem | ModContinueQueueItem;
+/** Coalescable items can be merged into a single submission batch. */
+export declare function isCoalescable(kind: QueueItemKind): boolean;
+export interface DequeuedBatch {
+    batchId: string;
+    items: QueueItem[];
+    /**
+     * Number of items that were merged into this batch.
+     * Equal to items.length for coalescable batches; 1 for barrier items.
+     */
+    mergedCount: number;
+    /** Queue length after this batch was removed. */
+    queueLenAfter: number;
+}
+export interface QueueCallbacks {
+    onEnqueued?: (item: QueueItem, queueLen: number) => void;
+    onDequeued?: (batch: DequeuedBatch) => void;
+    /**
+     * Fired on blocked-reason state transitions (not on every check).
+     * Only fires when queue is non-empty.
+     */
+    onBlocked?: (reason: QueueBlockedReason, queueLen: number) => void;
+    onCleared?: (reason: QueueClearedReason, clearedCount: number, items: QueueItem[]) => void;
+    /**
+     * Fired when an item is dropped.
+     * queueLen is the post-operation queue depth:
+     * - Soft-limit coalescable drop: one removed, one added → net unchanged.
+     * - Hard-ceiling rejection: item not added → current length unchanged.
+     */
+    onDropped?: (item: QueueItem, reason: QueueItemDroppedReason, queueLen: number) => void;
+    /**
+     * Fired when an item is explicitly removed via removeItem().
+     * queueLen is the post-removal queue depth.
+     */
+    onRemoved?: (item: QueueItem, queueLen: number) => void;
+}
+export interface QueueRuntimeOptions {
+    /**
+     * Soft limit. When reached, the oldest coalescable item is dropped
+     * to make room for a new one. Default: 100.
+     */
+    maxItems?: number;
+    /**
+     * Hard ceiling. When reached, enqueue is rejected entirely (returns null)
+     * for all item kinds and onDropped fires. Default: maxItems * 3.
+     */
+    hardMaxItems?: number;
+    callbacks?: QueueCallbacks;
+}
+export declare class QueueRuntime {
+    private readonly store;
+    private readonly callbacks;
+    private readonly maxItems;
+    private readonly hardMaxItems;
+    private nextId;
+    private nextBatchId;
+    private lastEmittedBlockedReason;
+    private blockedEmittedForNonEmpty;
+    constructor(options?: QueueRuntimeOptions);
+    /**
+     * Add an item to the queue. Returns the enqueued item (with assigned id
+     * and enqueuedAt), or null if the hard ceiling was reached.
+     *
+     * - If at soft limit and item is coalescable: drops oldest coalescable item.
+     * - If at soft limit and item is a barrier: allows overflow (soft limit only
+     *   applies to coalescable items).
+     * - If at hard ceiling: rejects all item kinds, fires onDropped("buffer_limit").
+     */
+    enqueue(input: Omit<QueueItem, "id" | "enqueuedAt">): QueueItem | null;
+    /**
+     * Attempt to dequeue the next batch.
+     *
+     * Pass `blockedReason` (non-null) when the caller's gating conditions
+     * prevent submission. Pass `null` when submission is allowed.
+     *
+     * Returns null if blocked or queue is empty.
+     * Returns a DequeuedBatch with coalescable items (or a single barrier).
+     */
+    tryDequeue(blockedReason: QueueBlockedReason | null): DequeuedBatch | null;
+    /**
+     * Caller-controlled dequeue: removes exactly the first `n` items (or all
+     * available if fewer exist) without applying the coalescable/barrier policy.
+     * Used when the caller has already decided how many items to consume (e.g.
+     * headless coalescing loop, listen one-message-per-turn).
+     * Returns null if queue is empty or n <= 0.
+     */
+    consumeItems(n: number): DequeuedBatch | null;
+    /**
+     * Reset blocked-reason tracking after a turn completes (unblocked transition).
+     * Call when the consumer becomes idle so the next arrival can re-emit
+     * onBlocked correctly. Should only be called when the queue is actually
+     * idle (i.e. pendingTurns === 0 in listen, turnInProgress === false in headless).
+     */
+    resetBlockedState(): void;
+    /**
+     * Remove a specific item by ID. Returns the removed item, or null
+     * if no item with that ID exists. Fires onRemoved callback.
+     */
+    removeItem(id: string): QueueItem | null;
+    /** Remove all items and fire onCleared. */
+    clear(reason: QueueClearedReason): void;
+    get length(): number;
+    get isEmpty(): boolean;
+    get items(): readonly QueueItem[];
+    peek(): readonly QueueItem[];
+    private makeItem;
+    private safeCallback;
+}
+//# sourceMappingURL=queue-runtime.d.ts.map

package/dist/types/queue/queue-runtime.d.ts.map

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

package/dist/types/reminders/state.d.ts

@@ -0,0 +1,45 @@
+import type { ContextTracker } from "../cli/helpers/context-tracker";
+import type { PermissionMode } from "../permissions/mode";
+export interface CommandIoReminder {
+    input: string;
+    output: string;
+    success: boolean;
+    /** Extra context appended only in the agent-facing reminder, not shown in the UI. */
+    agentHint?: string;
+}
+export interface ToolsetChangeReminder {
+    source: string;
+    previousToolset: string | null;
+    newToolset: string | null;
+    previousTools: string[];
+    newTools: string[];
+}
+export interface MemoryGitSyncReminder {
+    text: string;
+}
+export type SessionContextReason = "initial_attach" | "cwd_changed";
+export interface SharedReminderState {
+    hasSentAgentInfo: boolean;
+    hasSentSessionContext: boolean;
+    hasSentConversationBootstrap: boolean;
+    pendingConversationBootstrap: boolean;
+    hasSentSecretsInfo: boolean;
+    pendingSecretsInfoRefresh: boolean;
+    lastSentSecretNamesKey: string | null;
+    lastNotifiedPermissionMode: PermissionMode | null;
+    turnCount: number;
+    pendingReflectionTrigger: boolean;
+    pendingMemoryGitSyncReminders: MemoryGitSyncReminder[];
+    pendingCommandIoReminders: CommandIoReminder[];
+    pendingToolsetChangeReminders: ToolsetChangeReminder[];
+    /** When set, the next session-context reminder uses this reason for its intro text. */
+    pendingSessionContextReason?: SessionContextReason;
+}
+export declare function createSharedReminderState(): SharedReminderState;
+export declare function resetSharedReminderState(state: SharedReminderState): void;
+export declare function syncReminderStateFromContextTracker(state: SharedReminderState, contextTracker: ContextTracker): void;
+export declare function enqueueCommandIoReminder(state: SharedReminderState, reminder: CommandIoReminder): void;
+export declare function enqueueMemoryGitSyncReminder(state: SharedReminderState, reminder: MemoryGitSyncReminder): void;
+export declare function enqueueToolsetChangeReminder(state: SharedReminderState, reminder: ToolsetChangeReminder): void;
+export declare function markSecretsInfoReminderPending(state: SharedReminderState): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/types/reminders/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/reminders/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4BAA4B,EAAE,OAAO,CAAC;IACtC,4BAA4B,EAAE,OAAO,CAAC;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,yBAAyB,EAAE,OAAO,CAAC;IACnC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,0BAA0B,EAAE,cAAc,GAAG,IAAI,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,OAAO,CAAC;IAClC,6BAA6B,EAAE,qBAAqB,EAAE,CAAC;IACvD,yBAAyB,EAAE,iBAAiB,EAAE,CAAC;IAC/C,6BAA6B,EAAE,qBAAqB,EAAE,CAAC;IACvD,uFAAuF;IACvF,2BAA2B,CAAC,EAAE,oBAAoB,CAAC;CACpD;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,CAgB/D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAEzE;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,mBAAmB,EAC1B,cAAc,EAAE,cAAc,GAC7B,IAAI,CAKN;AAUD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAEN;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mBAAmB,GACzB,IAAI,CAGN"}

package/dist/types/runtime-context.d.ts

@@ -0,0 +1,42 @@
+import type { SkillSource } from "./agent/skills";
+import type { MessageChannelToolDiscoveryScope } from "./channels/message-tool";
+import type { ChannelTurnSource } from "./channels/types";
+export type RuntimePermissionMode = "standard" | "acceptEdits" | "unrestricted" | "strict";
+export interface RuntimeContextSnapshot {
+    /** Listener transport connection that owns the current turn, when present. */
+    connectionId?: string | null;
+    agentId?: string | null;
+    agentName?: string | null;
+    conversationId?: string | null;
+    skillsDirectory?: string | null;
+    skillSources?: SkillSource[];
+    workingDirectory?: string | null;
+    /**
+     * Set when the runtime-scoped working directory was found deleted and
+     * repaired to a fallback mid-turn. Holds the original (now missing) path
+     * until a shell tool consumes it to surface a note to the model.
+     */
+    workingDirectoryRecoveredFrom?: string | null;
+    toolContextId?: string | null;
+    permissionMode?: RuntimePermissionMode;
+    channelToolScope?: MessageChannelToolDiscoveryScope | null;
+    channelTurnSources?: ChannelTurnSource[];
+}
+export interface InheritedChannelContextPayload {
+    channelToolScope?: MessageChannelToolDiscoveryScope | null;
+    channelTurnSources?: ChannelTurnSource[];
+}
+export declare const LETTA_INHERITED_CHANNEL_CONTEXT_ENV = "LETTA_INHERITED_CHANNEL_CONTEXT";
+export declare function getRuntimeContext(): RuntimeContextSnapshot | undefined;
+export declare function runWithRuntimeContext<T>(snapshot: RuntimeContextSnapshot, fn: () => T): T;
+export declare function runOutsideRuntimeContext<T>(fn: () => T): T;
+export declare function updateRuntimeContext(update: Partial<RuntimeContextSnapshot>): void;
+export declare function getFallbackWorkingDirectory(): string;
+export declare function getCurrentWorkingDirectory(): string;
+/**
+ * Returns (and clears) the original path of a working directory that was
+ * repaired mid-turn because it no longer existed, or null when no recovery
+ * happened. Shell tools use this to tell the model its cwd changed.
+ */
+export declare function consumeWorkingDirectoryRecovery(): string | null;
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/types/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/runtime-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,aAAa,GACb,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,6BAA6B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,gBAAgB,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAC3D,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,8BAA8B;IAC7C,gBAAgB,CAAC,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAC3D,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,mCAAmC,oCACb,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,sBAAsB,GAAG,SAAS,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,QAAQ,EAAE,sBAAsB,EAChC,EAAE,EAAE,MAAM,CAAC,GACV,CAAC,CAeH;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE1D;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACtC,IAAI,CAgBN;AAUD,wBAAgB,2BAA2B,IAAI,MAAM,CAgBpD;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAwBnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,IAAI,CAQ/D"}