computer-agents 1.0.3 → 2.0.0

package/dist/cloud/resources/FilesResource.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Files Resource Manager
+ *
+ * Handles file operations within environment workspaces.
+ * Files are scoped to environments - each environment has its own isolated workspace.
+ *
+ * API Endpoints (matching server.ts):
+ * - GET    /environments/:environmentId/files              - List files
+ * - POST   /environments/:environmentId/files/upload       - Upload file (multipart)
+ * - POST   /environments/:environmentId/files/mkdir        - Create directory
+ * - GET    /environments/:environmentId/files/download/*   - Download file
+ * - DELETE /environments/:environmentId/files/*            - Delete file
+ * - POST   /environments/:environmentId/files/move         - Move/rename file
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesResource = void 0;
+const ApiClient_1 = require("../ApiClient");
+class FilesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List all files in an environment workspace
+     *
+     * @param environmentId - The environment ID
+     * @returns List of files with metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await client.files.list('env_xxx');
+     * console.log(result.files);
+     * ```
+     */
+    async list(environmentId) {
+        const response = await this.client.get(`/environments/${environmentId}/files`);
+        return {
+            environmentId,
+            files: response.data,
+        };
+    }
+    /**
+     * Alias for list() - for backward compatibility
+     */
+    async listFiles(environmentId) {
+        const response = await this.client.get(`/environments/${environmentId}/files`);
+        return response.data;
+    }
+    /**
+     * Download a file from an environment workspace
+     *
+     * @param environmentId - The environment ID
+     * @param filePath - Path to the file (e.g., 'src/app.py')
+     * @returns File content as string
+     *
+     * @example
+     * ```typescript
+     * const content = await client.files.getFile('env_xxx', 'src/app.py');
+     * console.log(content);
+     * ```
+     */
+    async getFile(environmentId, filePath) {
+        // Remove leading slash if present
+        const normalizedPath = filePath.replace(/^\/+/, '');
+        const encodedPath = normalizedPath
+            .split('/')
+            .map(encodeURIComponent)
+            .join('/');
+        const response = await this.client.request('GET', `/environments/${environmentId}/files/${encodedPath}`, { stream: true });
+        return response.text();
+    }
+    /**
+     * Download a file as a Buffer
+     *
+     * @param environmentId - The environment ID
+     * @param filePath - Path to the file
+     * @returns File content as Buffer
+     */
+    async downloadFile(environmentId, filePath) {
+        const normalizedPath = filePath.replace(/^\/+/, '');
+        const encodedPath = normalizedPath
+            .split('/')
+            .map(encodeURIComponent)
+            .join('/');
+        const response = await this.client.request('GET', `/environments/${environmentId}/files/${encodedPath}`, { stream: true });
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    /**
+     * Upload a file to an environment workspace
+     *
+     * Uses multipart form data to match the server.ts upload handler.
+     *
+     * @param params - Upload parameters
+     * @returns Upload result with file path
+     *
+     * @example
+     * ```typescript
+     * const result = await client.files.uploadFile({
+     *   environmentId: 'env_xxx',
+     *   filename: 'app.py',
+     *   path: 'src',  // Optional: subdirectory
+     *   content: 'print("Hello, world!")'
+     * });
+     * ```
+     */
+    async uploadFile(params) {
+        const { environmentId, path: relativePath, content, filename, contentType } = params;
+        if (!environmentId) {
+            throw new Error('environmentId is required for file upload');
+        }
+        // Create FormData for multipart upload
+        const formData = new FormData();
+        // Convert content to Blob
+        const contentBuffer = typeof content === 'string'
+            ? new TextEncoder().encode(content)
+            : content;
+        const blob = new Blob([contentBuffer], {
+            type: contentType || 'application/octet-stream'
+        });
+        formData.append('file', blob, filename);
+        if (relativePath) {
+            formData.append('path', relativePath);
+        }
+        // Make request with FormData (not JSON)
+        const url = `${this.client.getBaseUrl()}/environments/${environmentId}/files/upload`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.client.getApiKey()}`,
+            },
+            body: formData,
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({ error: response.statusText }));
+            throw new ApiClient_1.ApiClientError(errorData.message || errorData.error || 'Upload failed', response.status, errorData.code);
+        }
+        return response.json();
+    }
+    /**
+     * Delete a file from an environment workspace
+     *
+     * @param environmentId - The environment ID
+     * @param filePath - Path to the file to delete
+     *
+     * @example
+     * ```typescript
+     * await client.files.deleteFile('env_xxx', 'src/old-file.py');
+     * ```
+     */
+    async deleteFile(environmentId, filePath) {
+        const normalizedPath = filePath.replace(/^\/+/, '');
+        const encodedPath = normalizedPath
+            .split('/')
+            .map(encodeURIComponent)
+            .join('/');
+        return this.client.delete(`/environments/${environmentId}/files/${encodedPath}`);
+    }
+    /**
+     * Move or rename a file within an environment workspace
+     *
+     * @param params - Move parameters (environmentId, sourcePath, destPath)
+     * @returns Move result
+     *
+     * @example
+     * ```typescript
+     * await client.files.moveFile({
+     *   environmentId: 'env_xxx',
+     *   sourcePath: 'old-name.py',
+     *   destPath: 'new-name.py'
+     * });
+     * ```
+     */
+    async moveFile(params) {
+        const { environmentId, sourcePath, destPath } = params;
+        return this.client.post(`/environments/${environmentId}/files/move`, { sourcePath, destPath });
+    }
+    /**
+     * Create a directory in an environment workspace
+     *
+     * Parent directories are created automatically if they don't exist.
+     *
+     * @param environmentId - The environment ID
+     * @param path - Directory path to create (relative to workspace root)
+     * @returns Create directory result
+     *
+     * @example
+     * ```typescript
+     * // Create a simple directory
+     * await client.files.createDirectory('env_xxx', 'src/components');
+     *
+     * // Create nested directories (parents created automatically)
+     * await client.files.createDirectory('env_xxx', 'src/components/ui/buttons');
+     * ```
+     */
+    async createDirectory(environmentId, path) {
+        // Normalize path - remove leading slash if present
+        const normalizedPath = path.replace(/^\/+/, '');
+        return this.client.post(`/environments/${environmentId}/files/mkdir`, { path: normalizedPath });
+    }
+}
+exports.FilesResource = FilesResource;
+//# sourceMappingURL=FilesResource.js.map

package/dist/cloud/resources/FilesResource.js.map

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

package/dist/cloud/resources/GitResource.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Git Resource Manager
+ *
+ * Handles git operations on cloud workspaces including
+ * diff, commit, and push.
+ */
+import type { ApiClient } from '../ApiClient';
+import type { GitDiffResult, GitCommitParams, GitCommitResult, GitPushParams, GitPushResult } from '../types';
+export declare class GitResource {
+    private readonly client;
+    constructor(client: ApiClient);
+    /**
+     * Get uncommitted changes in a workspace
+     */
+    diff(workspaceId: string): Promise<GitDiffResult>;
+    /**
+     * Create a git commit
+     */
+    commit(workspaceId: string, params: GitCommitParams): Promise<GitCommitResult>;
+    /**
+     * Push commits to remote
+     */
+    push(workspaceId: string, params?: GitPushParams): Promise<GitPushResult>;
+    /**
+     * Get diff for a specific commit
+     */
+    getCommitDiff(workspaceId: string, commitSha: string): Promise<GitDiffResult>;
+}

package/dist/cloud/resources/GitResource.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Git Resource Manager
+ *
+ * Handles git operations on cloud workspaces including
+ * diff, commit, and push.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitResource = void 0;
+class GitResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get uncommitted changes in a workspace
+     */
+    async diff(workspaceId) {
+        const response = await this.client.get(`/git/${workspaceId}/diff`);
+        return response;
+    }
+    /**
+     * Create a git commit
+     */
+    async commit(workspaceId, params) {
+        const response = await this.client.post(`/git/${workspaceId}/commit`, params);
+        return response;
+    }
+    /**
+     * Push commits to remote
+     */
+    async push(workspaceId, params = {}) {
+        const response = await this.client.post(`/git/${workspaceId}/push`, params);
+        return response;
+    }
+    /**
+     * Get diff for a specific commit
+     */
+    async getCommitDiff(workspaceId, commitSha) {
+        const response = await this.client.get(`/git/${workspaceId}/commits/${commitSha}/diff`);
+        return response;
+    }
+}
+exports.GitResource = GitResource;
+//# sourceMappingURL=GitResource.js.map

package/dist/cloud/resources/GitResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitResource.js","sourceRoot":"","sources":["../../../src/cloud/resources/GitResource.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAWH,MAAa,WAAW;IACO;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,QAAQ,WAAW,OAAO,CAC3B,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,MAAuB;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,QAAQ,WAAW,SAAS,EAC5B,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,SAAwB,EAAE;QAE1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,QAAQ,WAAW,OAAO,EAC1B,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB,EAAE,SAAiB;QACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,QAAQ,WAAW,YAAY,SAAS,OAAO,CAChD,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAlDD,kCAkDC"}

package/dist/cloud/resources/ProjectsResource.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Projects Resource Manager
+ *
+ * Handles project-related API operations including file management.
+ *
+ * Note: With the simplified API, each API key is bound to exactly one project.
+ * The project is determined automatically from the API key, so no projectId
+ * parameter is needed in method calls.
+ */
+import type { ApiClient } from '../ApiClient';
+import type { Project, UpdateProjectParams, ProjectStats, FileEntry, ListFilesParams, UploadFileParams, CreateDirectoryParams } from '../types';
+export declare class ProjectsResource {
+    private readonly client;
+    constructor(client: ApiClient);
+    /**
+     * Get the current project (bound to this API key)
+     *
+     * Project is determined automatically from the API key.
+     */
+    get(): Promise<Project & {
+        stats?: ProjectStats;
+    }>;
+    /**
+     * Update the current project
+     *
+     * Project is determined automatically from the API key.
+     */
+    update(params: UpdateProjectParams): Promise<Project>;
+    /**
+     * Sync project with cloud storage
+     *
+     * Project is determined automatically from the API key.
+     */
+    sync(changes?: {
+        added?: string[];
+        modified?: string[];
+        deleted?: string[];
+    }): Promise<{
+        synced: boolean;
+        fileCount: number;
+    }>;
+    /**
+     * List files in the project
+     *
+     * Project is determined automatically from the API key.
+     */
+    listFiles(params?: ListFilesParams): Promise<FileEntry[]>;
+    /**
+     * Get a file's content
+     *
+     * Project is determined automatically from the API key.
+     */
+    getFile(filePath: string, environmentId?: string): Promise<string>;
+    /**
+     * Upload a file
+     *
+     * Project is determined automatically from the API key.
+     */
+    uploadFile(params: UploadFileParams): Promise<FileEntry>;
+    /**
+     * Delete a file or directory
+     *
+     * Project is determined automatically from the API key.
+     */
+    deleteFile(filePath: string, recursive?: boolean): Promise<void>;
+    /**
+     * Move or rename a file
+     *
+     * Project is determined automatically from the API key.
+     */
+    moveFile(sourcePath: string, destinationPath: string): Promise<FileEntry>;
+    /**
+     * Create a directory
+     *
+     * Project is determined automatically from the API key.
+     */
+    createDirectory(params: CreateDirectoryParams): Promise<FileEntry>;
+}

package/dist/cloud/resources/ProjectsResource.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Projects Resource Manager
+ *
+ * Handles project-related API operations including file management.
+ *
+ * Note: With the simplified API, each API key is bound to exactly one project.
+ * The project is determined automatically from the API key, so no projectId
+ * parameter is needed in method calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectsResource = void 0;
+class ProjectsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the current project (bound to this API key)
+     *
+     * Project is determined automatically from the API key.
+     */
+    async get() {
+        const response = await this.client.get(`/project`);
+        return response.project;
+    }
+    /**
+     * Update the current project
+     *
+     * Project is determined automatically from the API key.
+     */
+    async update(params) {
+        const response = await this.client.patch(`/project`, params);
+        return response.project;
+    }
+    /**
+     * Sync project with cloud storage
+     *
+     * Project is determined automatically from the API key.
+     */
+    async sync(changes) {
+        const response = await this.client.post(`/project/sync`, { changes });
+        return response;
+    }
+    // =========================================================================
+    // File Operations
+    // =========================================================================
+    /**
+     * List files in the project
+     *
+     * Project is determined automatically from the API key.
+     */
+    async listFiles(params = {}) {
+        const response = await this.client.get(`/files`, {
+            path: params.path,
+            environmentId: params.environmentId,
+            recursive: params.recursive,
+        });
+        return response.files;
+    }
+    /**
+     * Get a file's content
+     *
+     * Project is determined automatically from the API key.
+     */
+    async getFile(filePath, environmentId) {
+        const encodedPath = encodeURIComponent(filePath);
+        const response = await this.client.get(`/files/${encodedPath}`, { environmentId });
+        return response;
+    }
+    /**
+     * Upload a file
+     *
+     * Project is determined automatically from the API key.
+     */
+    async uploadFile(params) {
+        // For single file upload, we use the PUT endpoint
+        const encodedPath = encodeURIComponent(params.path);
+        const response = await this.client.put(`/files/${encodedPath}`, {
+            content: typeof params.content === 'string'
+                ? params.content
+                : params.content.toString('base64'),
+            contentType: params.contentType,
+            environmentId: params.environmentId,
+        });
+        return response.file;
+    }
+    /**
+     * Delete a file or directory
+     *
+     * Project is determined automatically from the API key.
+     */
+    async deleteFile(filePath, recursive = false) {
+        const encodedPath = encodeURIComponent(filePath);
+        await this.client.delete(`/files/${encodedPath}${recursive ? '?recursive=true' : ''}`);
+    }
+    /**
+     * Move or rename a file
+     *
+     * Project is determined automatically from the API key.
+     */
+    async moveFile(sourcePath, destinationPath) {
+        const response = await this.client.post(`/files/move`, { source: sourcePath, destination: destinationPath });
+        return response.file;
+    }
+    /**
+     * Create a directory
+     *
+     * Project is determined automatically from the API key.
+     */
+    async createDirectory(params) {
+        const response = await this.client.post(`/directories`, params);
+        return response.directory;
+    }
+}
+exports.ProjectsResource = ProjectsResource;
+//# sourceMappingURL=ProjectsResource.js.map

package/dist/cloud/resources/ProjectsResource.js.map

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

package/dist/cloud/resources/RunsResource.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Runs Resource Manager
+ *
+ * Handles execution tracking including CRUD operations,
+ * logs retrieval, and file diffs.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+import type { ApiClient } from '../ApiClient';
+import type { Run, CreateRunParams, UpdateRunParams, ListRunsParams, RunLogEntry, RunDiff } from '../types';
+export declare class RunsResource {
+    private readonly client;
+    constructor(client: ApiClient);
+    /**
+     * Create a new run
+     *
+     * Project is determined automatically from the API key.
+     */
+    create(params: CreateRunParams): Promise<Run>;
+    /**
+     * List runs
+     *
+     * Project is determined automatically from the API key.
+     */
+    list(params?: ListRunsParams): Promise<{
+        runs: Run[];
+        pagination: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+    }>;
+    /**
+     * Get a run by ID
+     */
+    get(runId: string): Promise<Run>;
+    /**
+     * Update a run
+     */
+    update(runId: string, params: UpdateRunParams): Promise<Run>;
+    /**
+     * Delete a run
+     */
+    delete(runId: string): Promise<void>;
+    /**
+     * Get logs for a run
+     */
+    getLogs(runId: string, options?: {
+        level?: 'all' | 'info' | 'error';
+        format?: 'json' | 'text';
+    }): Promise<RunLogEntry[]>;
+    /**
+     * Append a log entry to a run
+     */
+    appendLog(runId: string, entry: Omit<RunLogEntry, 'timestamp'>): Promise<void>;
+    /**
+     * Get file diffs for a run
+     */
+    getDiffs(runId: string): Promise<RunDiff[]>;
+}

package/dist/cloud/resources/RunsResource.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Runs Resource Manager
+ *
+ * Handles execution tracking including CRUD operations,
+ * logs retrieval, and file diffs.
+ *
+ * Note: projectId is now embedded in the API key, so routes use
+ * simplified paths without /projects/:projectId prefix.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunsResource = void 0;
+class RunsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new run
+     *
+     * Project is determined automatically from the API key.
+     */
+    async create(params) {
+        const response = await this.client.post(`/runs`, params);
+        return response.run;
+    }
+    /**
+     * List runs
+     *
+     * Project is determined automatically from the API key.
+     */
+    async list(params = {}) {
+        const response = await this.client.get(`/runs`, {
+            limit: params.limit,
+            offset: params.offset,
+            threadId: params.threadId,
+            status: params.status,
+            since: params.since,
+        });
+        return response;
+    }
+    /**
+     * Get a run by ID
+     */
+    async get(runId) {
+        const response = await this.client.get(`/runs/${runId}`);
+        return response.run;
+    }
+    /**
+     * Update a run
+     */
+    async update(runId, params) {
+        const response = await this.client.patch(`/runs/${runId}`, params);
+        return response.run;
+    }
+    /**
+     * Delete a run
+     */
+    async delete(runId) {
+        await this.client.delete(`/runs/${runId}`);
+    }
+    /**
+     * Get logs for a run
+     */
+    async getLogs(runId, options) {
+        const response = await this.client.get(`/runs/${runId}/logs`, options);
+        return response.logs;
+    }
+    /**
+     * Append a log entry to a run
+     */
+    async appendLog(runId, entry) {
+        await this.client.post(`/runs/${runId}/logs`, entry);
+    }
+    /**
+     * Get file diffs for a run
+     */
+    async getDiffs(runId) {
+        const response = await this.client.get(`/threads/${runId}/diffs`);
+        return response.diffs;
+    }
+}
+exports.RunsResource = RunsResource;
+//# sourceMappingURL=RunsResource.js.map

package/dist/cloud/resources/RunsResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunsResource.js","sourceRoot":"","sources":["../../../src/cloud/resources/RunsResource.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAYH,MAAa,YAAY;IACM;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAuB;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,OAAO,EACP,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,SAAyB,EAAE;QAIpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAGnC,OAAO,EAAE;YACV,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,SAAS,KAAK,EAAE,CACjB,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,MAAuB;QAEvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACtC,SAAS,KAAK,EAAE,EAChB,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAa,EACb,OAAwE;QAExE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,SAAS,KAAK,OAAO,EACrB,OAAO,CACR,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,KAAa,EACb,KAAqC;QAErC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACpC,YAAY,KAAK,QAAQ,CAC1B,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;CACF;AAtGD,oCAsGC"}