@generacy-ai/generacy-plugin-claude-code 0.0.0-preview-20260304013206

package/dist/schemas.js

@@ -0,0 +1,75 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Zod validation schemas for runtime validation of configurations.
+ */
+import { z } from 'zod';
+/**
+ * Schema for volume mounts.
+ */
+export const MountSchema = z.object({
+    /** Host path or volume name */
+    source: z.string().min(1, 'Mount source is required'),
+    /** Container path (must be absolute) */
+    target: z.string().startsWith('/', 'Mount target must be an absolute path'),
+    /** Mount as read-only */
+    readonly: z.boolean().optional(),
+});
+/**
+ * Schema for resource limits.
+ */
+export const ResourceLimitsSchema = z.object({
+    /** Memory limit in bytes */
+    memory: z.number().positive('Memory must be positive').optional(),
+    /** CPU quota (e.g., 1.5 for 1.5 CPUs) */
+    cpus: z.number().positive('CPUs must be positive').optional(),
+});
+/**
+ * Schema for container configuration.
+ */
+export const ContainerConfigSchema = z.object({
+    /** Docker image to use */
+    image: z.string().min(1, 'Image is required'),
+    /** Working directory inside container (must be absolute) */
+    workdir: z.string().startsWith('/', 'Working directory must be an absolute path'),
+    /** Environment variables */
+    env: z.record(z.string()).default({}),
+    /** Volume mounts */
+    mounts: z.array(MountSchema).default([]),
+    /** Docker network name */
+    network: z.string().min(1, 'Network name is required'),
+    /** Optional resource limits */
+    resources: ResourceLimitsSchema.optional(),
+});
+/**
+ * Schema for invocation options.
+ */
+export const InvokeOptionsSchema = z.object({
+    /** Agency mode to set before invocation */
+    mode: z.string().optional(),
+    /** Maximum execution time in milliseconds (max 1 hour) */
+    timeout: z
+        .number()
+        .int('Timeout must be an integer')
+        .positive('Timeout must be positive')
+        .max(3600000, 'Timeout cannot exceed 1 hour (3600000ms)')
+        .optional(),
+    /** Tool whitelist (empty = all allowed) */
+    tools: z.array(z.string()).optional(),
+    /** Serialized context for workflow continuity */
+    context: z.string().optional(),
+    /** Associated GitHub issue number */
+    issueNumber: z.number().int().positive().optional(),
+});
+/**
+ * Schema for invocation parameters.
+ */
+export const InvokeParamsSchema = z.object({
+    /** The prompt to send to the agent */
+    prompt: z.string().min(1, 'Prompt is required'),
+    /** Optional session ID for session-based invocation */
+    sessionId: z.string().optional(),
+    /** Optional overrides for invoke options */
+    options: InvokeOptionsSchema.partial().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/session/session-manager.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Session manager implementing the registry pattern for sessions.
+ */
+import type { Logger } from 'pino';
+import type { Session as SessionInterface, QuestionPayload, TerminationReason } from '../types.js';
+import { Session } from './session.js';
+import type { CreateSessionOptions, SessionSummary } from './types.js';
+/**
+ * SessionManager options.
+ */
+export interface SessionManagerOptions {
+    /** Session timeout in milliseconds */
+    sessionTimeoutMs?: number;
+    /** Cleanup interval in milliseconds */
+    cleanupIntervalMs?: number;
+    /** Maximum concurrent sessions */
+    maxSessions?: number;
+}
+/**
+ * Session manager implementing the registry pattern.
+ * Manages session lifecycle, registration, and cleanup.
+ */
+export declare class SessionManager {
+    private readonly logger;
+    private readonly sessions;
+    private readonly options;
+    private cleanupTimer?;
+    constructor(logger: Logger, options?: SessionManagerOptions);
+    /**
+     * Create a new session.
+     */
+    create(options: CreateSessionOptions): Session;
+    /**
+     * Get a session by ID.
+     * Throws SessionNotFoundError if not found.
+     */
+    get(sessionId: string): Session;
+    /**
+     * Get a session by ID, returning undefined if not found.
+     */
+    find(sessionId: string): Session | undefined;
+    /**
+     * Check if a session exists.
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Get a session's public interface.
+     */
+    getSession(sessionId: string): SessionInterface;
+    /**
+     * List all active sessions.
+     */
+    listActive(): SessionSummary[];
+    /**
+     * List all sessions.
+     */
+    listAll(): SessionSummary[];
+    /**
+     * Get the count of active sessions.
+     */
+    getActiveCount(): number;
+    /**
+     * Get total session count.
+     */
+    getTotalCount(): number;
+    /**
+     * Mark a session as having a started container.
+     */
+    onContainerStarted(sessionId: string, containerId: string): void;
+    /**
+     * Mark a session as executing an invocation.
+     */
+    onInvocationStarted(sessionId: string, invocationId: string): void;
+    /**
+     * Mark a session's invocation as completed.
+     */
+    onInvocationCompleted(sessionId: string): void;
+    /**
+     * Mark a session as awaiting input.
+     */
+    onQuestionReceived(sessionId: string, question: QuestionPayload): void;
+    /**
+     * Mark a session as having received an answer.
+     */
+    onAnswerProvided(sessionId: string): void;
+    /**
+     * Terminate a session.
+     */
+    terminate(sessionId: string, reason: TerminationReason): void;
+    /**
+     * Remove a session from the registry.
+     */
+    remove(sessionId: string): boolean;
+    /**
+     * Clean up expired sessions.
+     */
+    cleanupExpiredSessions(): number;
+    /**
+     * Clean up all sessions.
+     */
+    cleanupAll(): void;
+    /**
+     * Stop the cleanup timer.
+     */
+    stopCleanupTimer(): void;
+    /**
+     * Dispose of the session manager.
+     */
+    dispose(): void;
+    /**
+     * Start the periodic cleanup timer.
+     */
+    private startCleanupTimer;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,KAAK,EACV,OAAO,IAAI,gBAAgB,EAC3B,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACf,MAAM,YAAY,CAAC;AAKpB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IAY/D;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO;IAoB9C;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAU/B;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI5C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAI/C;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAM9B;;OAEG;IACH,OAAO,IAAI,cAAc,EAAE;IAK3B;;OAEG;IACH,cAAc,IAAI,MAAM;IAMxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAQvB;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMhE;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAMlE;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM9C;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAStE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAgB7D;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAUlC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IA+BhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAclB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAOxB;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/session/session-manager.js

@@ -0,0 +1,243 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Session manager implementing the registry pattern for sessions.
+ */
+import { SessionNotFoundError, } from '../errors.js';
+import { Session } from './session.js';
+import { DEFAULT_SESSION_TIMEOUT_MS, } from './types.js';
+/**
+ * Session manager implementing the registry pattern.
+ * Manages session lifecycle, registration, and cleanup.
+ */
+export class SessionManager {
+    logger;
+    sessions = new Map();
+    options;
+    cleanupTimer;
+    constructor(logger, options = {}) {
+        this.logger = logger.child({ component: 'SessionManager' });
+        this.options = {
+            sessionTimeoutMs: options.sessionTimeoutMs ?? DEFAULT_SESSION_TIMEOUT_MS,
+            cleanupIntervalMs: options.cleanupIntervalMs ?? 60000, // 1 minute
+            maxSessions: options.maxSessions ?? 100,
+        };
+        // Start periodic cleanup
+        this.startCleanupTimer();
+    }
+    /**
+     * Create a new session.
+     */
+    create(options) {
+        // Check if we've reached max sessions
+        if (this.sessions.size >= this.options.maxSessions) {
+            this.logger.warn({ count: this.sessions.size }, 'Max sessions reached, attempting cleanup');
+            this.cleanupExpiredSessions();
+            if (this.sessions.size >= this.options.maxSessions) {
+                throw new Error(`Maximum sessions (${this.options.maxSessions}) reached`);
+            }
+        }
+        const session = new Session(options);
+        this.sessions.set(session.id, session);
+        this.logger.info({ sessionId: session.id }, 'Session created');
+        return session;
+    }
+    /**
+     * Get a session by ID.
+     * Throws SessionNotFoundError if not found.
+     */
+    get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new SessionNotFoundError(sessionId);
+        }
+        return session;
+    }
+    /**
+     * Get a session by ID, returning undefined if not found.
+     */
+    find(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Check if a session exists.
+     */
+    has(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    /**
+     * Get a session's public interface.
+     */
+    getSession(sessionId) {
+        return this.get(sessionId);
+    }
+    /**
+     * List all active sessions.
+     */
+    listActive() {
+        return Array.from(this.sessions.values())
+            .filter((session) => session.isActive())
+            .map((session) => session.getSummary());
+    }
+    /**
+     * List all sessions.
+     */
+    listAll() {
+        return Array.from(this.sessions.values())
+            .map((session) => session.getSummary());
+    }
+    /**
+     * Get the count of active sessions.
+     */
+    getActiveCount() {
+        return Array.from(this.sessions.values())
+            .filter((session) => session.isActive())
+            .length;
+    }
+    /**
+     * Get total session count.
+     */
+    getTotalCount() {
+        return this.sessions.size;
+    }
+    // ==========================================================================
+    // Session state transitions
+    // ==========================================================================
+    /**
+     * Mark a session as having a started container.
+     */
+    onContainerStarted(sessionId, containerId) {
+        const session = this.get(sessionId);
+        session.onContainerStarted(containerId);
+        this.logger.info({ sessionId, containerId }, 'Session container started');
+    }
+    /**
+     * Mark a session as executing an invocation.
+     */
+    onInvocationStarted(sessionId, invocationId) {
+        const session = this.get(sessionId);
+        session.onInvocationStarted(invocationId);
+        this.logger.debug({ sessionId, invocationId }, 'Session invocation started');
+    }
+    /**
+     * Mark a session's invocation as completed.
+     */
+    onInvocationCompleted(sessionId) {
+        const session = this.get(sessionId);
+        session.onInvocationCompleted();
+        this.logger.debug({ sessionId }, 'Session invocation completed');
+    }
+    /**
+     * Mark a session as awaiting input.
+     */
+    onQuestionReceived(sessionId, question) {
+        const session = this.get(sessionId);
+        session.onQuestionReceived(question);
+        this.logger.info({ sessionId, urgency: question.urgency }, 'Session question received');
+    }
+    /**
+     * Mark a session as having received an answer.
+     */
+    onAnswerProvided(sessionId) {
+        const session = this.get(sessionId);
+        session.onAnswerProvided();
+        this.logger.debug({ sessionId }, 'Session answer provided');
+    }
+    /**
+     * Terminate a session.
+     */
+    terminate(sessionId, reason) {
+        const session = this.find(sessionId);
+        if (!session) {
+            this.logger.warn({ sessionId }, 'Session not found for termination');
+            return;
+        }
+        session.terminate(reason);
+        this.logger.info({ sessionId, reason }, 'Session terminated');
+    }
+    // ==========================================================================
+    // Session cleanup
+    // ==========================================================================
+    /**
+     * Remove a session from the registry.
+     */
+    remove(sessionId) {
+        const existed = this.sessions.delete(sessionId);
+        if (existed) {
+            this.logger.info({ sessionId }, 'Session removed');
+        }
+        return existed;
+    }
+    /**
+     * Clean up expired sessions.
+     */
+    cleanupExpiredSessions() {
+        const now = Date.now();
+        const expiredIds = [];
+        for (const [id, session] of this.sessions) {
+            const age = now - session.lastActiveAt.getTime();
+            // Remove terminated sessions after a short grace period (1 minute)
+            if (!session.isActive() && age > 60000) {
+                expiredIds.push(id);
+                continue;
+            }
+            // Remove active sessions that have exceeded the timeout
+            if (session.isActive() && age > this.options.sessionTimeoutMs) {
+                session.terminate('timeout');
+                expiredIds.push(id);
+            }
+        }
+        for (const id of expiredIds) {
+            this.sessions.delete(id);
+        }
+        if (expiredIds.length > 0) {
+            this.logger.info({ count: expiredIds.length }, 'Cleaned up expired sessions');
+        }
+        return expiredIds.length;
+    }
+    /**
+     * Clean up all sessions.
+     */
+    cleanupAll() {
+        const count = this.sessions.size;
+        for (const session of this.sessions.values()) {
+            if (session.isActive()) {
+                session.terminate('user_requested');
+            }
+        }
+        this.sessions.clear();
+        this.logger.info({ count }, 'Cleaned up all sessions');
+    }
+    /**
+     * Stop the cleanup timer.
+     */
+    stopCleanupTimer() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+    }
+    /**
+     * Dispose of the session manager.
+     */
+    dispose() {
+        this.stopCleanupTimer();
+        this.cleanupAll();
+    }
+    // ==========================================================================
+    // Private methods
+    // ==========================================================================
+    /**
+     * Start the periodic cleanup timer.
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanupExpiredSessions();
+        }, this.options.cleanupIntervalMs);
+        // Don't let the timer prevent the process from exiting
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

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

package/dist/session/session.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @generacy-ai/generacy-plugin-claude-code
+ *
+ * Session class implementing a finite state machine for session lifecycle.
+ */
+import type { Session as SessionInterface, SessionState, SessionStatus, InvokeOptions, ContainerConfig, QuestionPayload, TerminationReason } from '../types.js';
+import type { SessionData, SessionEvent, CreateSessionOptions, UpdateSessionOptions, SessionSummary } from './types.js';
+/**
+ * Session class implementing a finite state machine.
+ * Manages session lifecycle with validated state transitions.
+ */
+export declare class Session implements SessionInterface {
+    private data;
+    constructor(options: CreateSessionOptions);
+    /**
+     * Create a session with a specific ID (for testing or restoration).
+     */
+    static withId(id: string, options: CreateSessionOptions): Session;
+    get id(): string;
+    get status(): SessionStatus;
+    get createdAt(): Date;
+    get lastActiveAt(): Date;
+    get state(): SessionState;
+    get containerConfig(): ContainerConfig;
+    get containerId(): string | undefined;
+    get invocationId(): string | undefined;
+    get defaultOptions(): InvokeOptions;
+    get pendingQuestion(): QuestionPayload | undefined;
+    /**
+     * Process an event and transition to a new state.
+     * Throws SessionInvalidStateError if the transition is invalid.
+     */
+    processEvent(event: SessionEvent): void;
+    /**
+     * Transition to running state when container starts.
+     */
+    onContainerStarted(containerId: string): void;
+    /**
+     * Transition to executing state when invocation starts.
+     */
+    onInvocationStarted(invocationId: string): void;
+    /**
+     * Transition back to running state when invocation completes.
+     */
+    onInvocationCompleted(): void;
+    /**
+     * Transition to awaiting_input state when a question is received.
+     */
+    onQuestionReceived(question: QuestionPayload): void;
+    /**
+     * Transition back from awaiting_input when answer is provided.
+     */
+    onAnswerProvided(): void;
+    /**
+     * Transition to terminated state.
+     */
+    terminate(reason: TerminationReason): void;
+    /**
+     * Update session data (partial update).
+     */
+    update(options: UpdateSessionOptions): void;
+    /**
+     * Check if the session is in an active (non-terminated) state.
+     */
+    isActive(): boolean;
+    /**
+     * Check if the session is ready to execute an invocation.
+     */
+    isReadyForInvocation(): boolean;
+    /**
+     * Check if the session is waiting for human input.
+     */
+    isAwaitingInput(): boolean;
+    /**
+     * Check if the session has a running container.
+     */
+    hasRunningContainer(): boolean;
+    /**
+     * Get a summary of the session for external visibility.
+     */
+    getSummary(): SessionSummary;
+    /**
+     * Export session data (for serialization).
+     */
+    toJSON(): SessionData;
+    /**
+     * Compute the next state based on the event.
+     */
+    private computeNextState;
+    /**
+     * Update auxiliary data based on event.
+     */
+    private updateFromEvent;
+    /**
+     * Get container ID or throw if not available.
+     */
+    private getContainerIdOrThrow;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,OAAO,IAAI,gBAAgB,EAC3B,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,qBAAa,OAAQ,YAAW,gBAAgB;IAC9C,OAAO,CAAC,IAAI,CAAc;gBAEd,OAAO,EAAE,oBAAoB;IAazC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO;IAUjE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,IAAI,YAAY,IAAI,IAAI,CAEvB;IAMD,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,cAAc,IAAI,aAAa,CAElC;IAED,IAAI,eAAe,IAAI,eAAe,GAAG,SAAS,CAEjD;IAMD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAmBvC;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInD;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAc1C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAgB3C;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAK9B;;OAEG;IACH,UAAU,IAAI,cAAc;IAW5B;;OAEG;IACH,MAAM,IAAI,WAAW;IAQrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAY9B"}