@enactprotocol/api 2.0.0 → 2.0.2

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * @enactprotocol/api - Registry API client for Enact tools (v2)
+ *
+ * This package provides HTTP client functionality for interacting with
+ * the Enact registry v2, including:
+ * - OAuth authentication
+ * - Tool search and discovery
+ * - Bundle download with yank handling
+ * - Tool publishing (multipart upload)
+ * - Attestation management
+ * - Trust configuration
+ *
+ * @packageDocumentation
+ */
+export const VERSION = "0.2.0";
+// =============================================================================
+// Types
+// =============================================================================
+export * from "./types";
+// =============================================================================
+// Client
+// =============================================================================
+export { EnactApiClient, createApiClient } from "./client";
+// =============================================================================
+// Search
+// =============================================================================
+export { searchTools } from "./search";
+// =============================================================================
+// Download
+// =============================================================================
+export { downloadBundle, getToolInfo, getToolVersion, getAttestations } from "./download";
+// =============================================================================
+// Publish
+// =============================================================================
+export { publishTool, createBundle, submitAttestation, yankVersion, unyankVersion, deleteTool, } from "./publish";
+// =============================================================================
+// Auth (v2 OAuth)
+// =============================================================================
+export { initiateLogin, exchangeCodeForToken, refreshAccessToken, getCurrentUser, authenticate, logout, getAuthStatus, getUserProfile, submitFeedback, } from "./auth";
+// =============================================================================
+// Attestations (v2)
+// =============================================================================
+export { getAttestations as getAttestationList, submitAttestation as submitAttestationToRegistry, revokeAttestation, hasAttestation, getAttestationBundle, verifyAttestationLocally, verifyAllAttestations, hasTrustedAttestation, } from "./attestations";
+// =============================================================================
+// Trust (v2)
+// =============================================================================
+export { getUserTrust, updateMyTrust, addTrustedAuditor, removeTrustedAuditor, userTrustsAuditor, getMyTrustedAuditors, } from "./trust";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,cAAc,SAAS,CAAC;AAExB,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3D,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG1F,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,WAAW,CAAC;AASnB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,MAAM,EACN,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,QAAQ,CAAC;AAGhB,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EACL,eAAe,IAAI,kBAAkB,EACrC,iBAAiB,IAAI,2BAA2B,EAChD,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/publish.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Tool publishing functionality (v2)
+ * Implements bundle creation and publishing to registry
+ */
+import type { EnactApiClient } from "./client";
+/**
+ * Publish options
+ */
+export interface PublishOptions {
+    /** Tool name (e.g., "alice/utils/greeter") */
+    name: string;
+    /** Tool version (e.g., "1.2.0") */
+    version: string;
+    /** Bundle data (tar.gz) */
+    bundle: ArrayBuffer | Uint8Array;
+}
+/**
+ * Publish result
+ */
+export interface PublishResult {
+    /** Tool name */
+    name: string;
+    /** Published version */
+    version: string;
+    /** Publication timestamp */
+    publishedAt: Date;
+    /** Bundle hash */
+    bundleHash: string;
+}
+/**
+ * Bundle info (for createBundle)
+ */
+export interface BundleInfo {
+    /** Bundle data */
+    data: Uint8Array;
+    /** SHA-256 hash */
+    hash: string;
+    /** Size in bytes */
+    size: number;
+}
+/**
+ * Attestation submission options (v2)
+ */
+export interface SubmitAttestationOptions {
+    /** Tool name */
+    name: string;
+    /** Tool version */
+    version: string;
+    /** Sigstore bundle (full bundle object) */
+    sigstoreBundle: Record<string, unknown>;
+}
+/**
+ * Attestation submission result (v2)
+ */
+export interface AttestationResult {
+    /** Auditor email */
+    auditor: string;
+    /** OAuth provider */
+    auditorProvider: string;
+    /** Signing timestamp */
+    signedAt: Date;
+    /** Rekor log ID */
+    rekorLogId: string;
+    /** Rekor log index */
+    rekorLogIndex?: number | undefined;
+    /** Verification result */
+    verification: {
+        verified: boolean;
+        verifiedAt: Date;
+        rekorVerified: boolean;
+        certificateVerified: boolean;
+        signatureVerified: boolean;
+    };
+}
+/**
+ * Create a bundle from tool directory
+ *
+ * This is a placeholder that would typically:
+ * 1. Read all files from the tool directory
+ * 2. Create a tar.gz archive
+ * 3. Compute SHA-256 hash
+ *
+ * @param toolDir - Path to tool directory
+ * @returns Bundle info with data and hash
+ */
+export declare function createBundle(toolDir: string): Promise<BundleInfo>;
+/**
+ * Publish a tool to the registry (v2 - multipart upload)
+ *
+ * @param client - API client instance (must be authenticated)
+ * @param options - Publish options with manifest and bundle
+ * @returns Publish result
+ *
+ * @example
+ * ```ts
+ * const bundle = await createBundle("./my-tool");
+ * const result = await publishTool(client, {
+ *   name: "alice/utils/greeter",
+ *   manifest: { enact: "2.0.0", name: "alice/utils/greeter", version: "1.2.0", ... },
+ *   bundle: bundle.data,
+ *   readme: "# My Tool\n\nDescription..."
+ * });
+ * console.log(`Published: ${result.bundleHash}`);
+ * ```
+ */
+export declare function publishTool(client: EnactApiClient, options: {
+    name: string;
+    manifest: Record<string, unknown>;
+    bundle: ArrayBuffer | Uint8Array;
+    readme?: string | undefined;
+}): Promise<PublishResult>;
+/**
+ * Submit an attestation for a tool version (v2)
+ *
+ * @param client - API client instance (must be authenticated via OIDC)
+ * @param options - Attestation options
+ * @returns Attestation result
+ */
+export declare function submitAttestation(client: EnactApiClient, options: SubmitAttestationOptions): Promise<AttestationResult>;
+/**
+ * Yank a tool version (v2)
+ *
+ * Yanked versions remain downloadable but are excluded from version listings
+ * by default and show warnings to users.
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name
+ * @param version - Version to yank
+ * @param options - Yank options (reason, replacement)
+ * @returns Yank result
+ *
+ * @example
+ * ```ts
+ * const result = await yankVersion(client, "alice/utils/greeter", "1.1.0", {
+ *   reason: "Security vulnerability CVE-2025-1234",
+ *   replacementVersion: "1.2.0"
+ * });
+ * ```
+ */
+export declare function yankVersion(client: EnactApiClient, name: string, version: string, options?: {
+    reason?: string | undefined;
+    replacementVersion?: string | undefined;
+}): Promise<{
+    yanked: true;
+    version: string;
+    reason?: string | undefined;
+    replacementVersion?: string | undefined;
+    yankedAt: Date;
+}>;
+/**
+ * Unyank a tool version (v2)
+ *
+ * Restore a previously yanked version.
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name
+ * @param version - Version to unyank
+ * @returns Unyank result
+ *
+ * @example
+ * ```ts
+ * const result = await unyankVersion(client, "alice/utils/greeter", "1.1.0");
+ * ```
+ */
+export declare function unyankVersion(client: EnactApiClient, name: string, version: string): Promise<{
+    yanked: false;
+    version: string;
+    unyankedAt: Date;
+}>;
+/**
+ * Delete a tool from the registry
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name to delete
+ */
+export declare function deleteTool(client: EnactApiClient, name: string): Promise<void>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

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

package/dist/publish.js

@@ -0,0 +1,174 @@
+/**
+ * Tool publishing functionality (v2)
+ * Implements bundle creation and publishing to registry
+ */
+/**
+ * Create a bundle from tool directory
+ *
+ * This is a placeholder that would typically:
+ * 1. Read all files from the tool directory
+ * 2. Create a tar.gz archive
+ * 3. Compute SHA-256 hash
+ *
+ * @param toolDir - Path to tool directory
+ * @returns Bundle info with data and hash
+ */
+export async function createBundle(toolDir) {
+    // This would use @enactprotocol/shared utilities to:
+    // 1. Read files from toolDir
+    // 2. Create tarball
+    // 3. Compute hash
+    // For now, this is a placeholder that throws
+    // The actual implementation would integrate with the shared package
+    throw new Error(`createBundle not yet implemented for: ${toolDir}`);
+}
+/**
+ * Publish a tool to the registry (v2 - multipart upload)
+ *
+ * @param client - API client instance (must be authenticated)
+ * @param options - Publish options with manifest and bundle
+ * @returns Publish result
+ *
+ * @example
+ * ```ts
+ * const bundle = await createBundle("./my-tool");
+ * const result = await publishTool(client, {
+ *   name: "alice/utils/greeter",
+ *   manifest: { enact: "2.0.0", name: "alice/utils/greeter", version: "1.2.0", ... },
+ *   bundle: bundle.data,
+ *   readme: "# My Tool\n\nDescription..."
+ * });
+ * console.log(`Published: ${result.bundleHash}`);
+ * ```
+ */
+export async function publishTool(client, options) {
+    const { name, manifest, bundle, readme } = options;
+    // Create FormData for multipart upload
+    const formData = new FormData();
+    // Add manifest as JSON
+    formData.append("manifest", JSON.stringify(manifest));
+    // Add bundle as file
+    const bundleBlob = bundle instanceof ArrayBuffer
+        ? new Blob([bundle], { type: "application/gzip" })
+        : new Blob([bundle], { type: "application/gzip" });
+    formData.append("bundle", bundleBlob, "bundle.tar.gz");
+    // Add optional readme
+    if (readme) {
+        formData.append("readme", readme);
+    }
+    // Make multipart request (v2 endpoint is POST /tools/{name})
+    const response = await fetch(`${client.getBaseUrl()}/tools/${name}`, {
+        method: "POST",
+        headers: {
+            Authorization: client.getAuthToken() ? `Bearer ${client.getAuthToken()}` : "",
+            "User-Agent": client.getUserAgent() || "enact-cli/0.1.0",
+        },
+        body: formData,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Publish failed: ${response.status} - ${errorText}`);
+    }
+    const json = (await response.json());
+    // Handle both wrapped and unwrapped responses
+    const data = "data" in json ? json.data : json;
+    return {
+        name: data.name,
+        version: data.version,
+        publishedAt: new Date(data.published_at),
+        bundleHash: data.bundle_hash,
+    };
+}
+/**
+ * Submit an attestation for a tool version (v2)
+ *
+ * @param client - API client instance (must be authenticated via OIDC)
+ * @param options - Attestation options
+ * @returns Attestation result
+ */
+export async function submitAttestation(client, options) {
+    const { name, version, sigstoreBundle } = options;
+    const response = await client.post(`/tools/${name}/versions/${version}/attestations`, {
+        bundle: sigstoreBundle,
+    });
+    return {
+        auditor: response.data.auditor,
+        auditorProvider: response.data.auditor_provider,
+        signedAt: new Date(response.data.signed_at),
+        rekorLogId: response.data.rekor_log_id,
+        rekorLogIndex: response.data.rekor_log_index,
+        verification: {
+            verified: response.data.verification.verified,
+            verifiedAt: new Date(response.data.verification.verified_at),
+            rekorVerified: response.data.verification.rekor_verified,
+            certificateVerified: response.data.verification.certificate_verified,
+            signatureVerified: response.data.verification.signature_verified,
+        },
+    };
+}
+/**
+ * Yank a tool version (v2)
+ *
+ * Yanked versions remain downloadable but are excluded from version listings
+ * by default and show warnings to users.
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name
+ * @param version - Version to yank
+ * @param options - Yank options (reason, replacement)
+ * @returns Yank result
+ *
+ * @example
+ * ```ts
+ * const result = await yankVersion(client, "alice/utils/greeter", "1.1.0", {
+ *   reason: "Security vulnerability CVE-2025-1234",
+ *   replacementVersion: "1.2.0"
+ * });
+ * ```
+ */
+export async function yankVersion(client, name, version, options) {
+    const response = await client.post(`/tools/${name}/versions/${version}/yank`, {
+        reason: options?.reason,
+        replacement_version: options?.replacementVersion,
+    });
+    return {
+        yanked: response.data.yanked,
+        version: response.data.version,
+        reason: response.data.reason,
+        replacementVersion: response.data.replacement_version,
+        yankedAt: new Date(response.data.yanked_at),
+    };
+}
+/**
+ * Unyank a tool version (v2)
+ *
+ * Restore a previously yanked version.
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name
+ * @param version - Version to unyank
+ * @returns Unyank result
+ *
+ * @example
+ * ```ts
+ * const result = await unyankVersion(client, "alice/utils/greeter", "1.1.0");
+ * ```
+ */
+export async function unyankVersion(client, name, version) {
+    const response = await client.post(`/tools/${name}/versions/${version}/unyank`);
+    return {
+        yanked: response.data.yanked,
+        version: response.data.version,
+        unyankedAt: new Date(response.data.unyanked_at),
+    };
+}
+/**
+ * Delete a tool from the registry
+ *
+ * @param client - API client instance (must be authenticated and owner)
+ * @param name - Tool name to delete
+ */
+export async function deleteTool(client, name) {
+    await client.delete(`/tools/${name}`);
+}
+//# sourceMappingURL=publish.js.map

package/dist/publish.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Tool search functionality
+ * Implements semantic search via registry API
+ */
+import type { EnactApiClient } from "./client";
+/**
+ * Search options
+ */
+export interface SearchOptions {
+    /** Search query (semantic) */
+    query: string;
+    /** Filter by tags (comma-separated or array) */
+    tags?: string | string[] | undefined;
+    /** Maximum results (default: 20, max: 100) */
+    limit?: number | undefined;
+    /** Pagination offset */
+    offset?: number | undefined;
+}
+/**
+ * Single search result with parsed data (v2)
+ */
+export interface SearchResult {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Tool tags */
+    tags: string[];
+    /** Latest version */
+    version: string;
+    /** Author */
+    author: {
+        username: string;
+        avatarUrl?: string | undefined;
+    };
+    /** Download count */
+    downloads: number;
+    /** Trust status */
+    trustStatus?: {
+        auditorCount: number;
+    } | undefined;
+}
+/**
+ * Search response with pagination info
+ */
+export interface SearchResponse {
+    /** Search results */
+    results: SearchResult[];
+    /** Total matching tools */
+    total: number;
+    /** Results limit used */
+    limit: number;
+    /** Results offset used */
+    offset: number;
+    /** Whether more results are available */
+    hasMore: boolean;
+}
+/**
+ * Search for tools in the registry
+ *
+ * @param client - API client instance
+ * @param options - Search options
+ * @returns Search results with pagination
+ *
+ * @example
+ * ```ts
+ * const client = createApiClient();
+ * const results = await searchTools(client, {
+ *   query: "pdf extraction",
+ *   tags: ["ai", "document"],
+ *   limit: 10
+ * });
+ * ```
+ */
+export declare function searchTools(client: EnactApiClient, options: SearchOptions): Promise<SearchResponse>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;IACF,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EACR;QACE,YAAY,EAAE,MAAM,CAAC;KACtB,GACD,SAAS,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAkCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/search.js

@@ -0,0 +1,66 @@
+/**
+ * Tool search functionality
+ * Implements semantic search via registry API
+ */
+/**
+ * Convert raw API result to clean SearchResult
+ */
+function toSearchResult(raw) {
+    return {
+        name: raw.name,
+        description: raw.description,
+        tags: raw.tags,
+        version: raw.version,
+        author: {
+            username: raw.author.username,
+            avatarUrl: raw.author.avatar_url,
+        },
+        downloads: raw.downloads,
+        trustStatus: raw.trust_status
+            ? {
+                auditorCount: raw.trust_status.auditor_count,
+            }
+            : undefined,
+    };
+}
+/**
+ * Search for tools in the registry
+ *
+ * @param client - API client instance
+ * @param options - Search options
+ * @returns Search results with pagination
+ *
+ * @example
+ * ```ts
+ * const client = createApiClient();
+ * const results = await searchTools(client, {
+ *   query: "pdf extraction",
+ *   tags: ["ai", "document"],
+ *   limit: 10
+ * });
+ * ```
+ */
+export async function searchTools(client, options) {
+    const params = new URLSearchParams();
+    params.set("q", options.query);
+    if (options.tags) {
+        const tagsStr = Array.isArray(options.tags) ? options.tags.join(",") : options.tags;
+        params.set("tags", tagsStr);
+    }
+    if (options.limit !== undefined) {
+        params.set("limit", String(Math.min(options.limit, 100)));
+    }
+    if (options.offset !== undefined) {
+        params.set("offset", String(options.offset));
+    }
+    const response = await client.get(`/tools/search?${params.toString()}`);
+    const results = response.data.tools.map(toSearchResult);
+    return {
+        results,
+        total: response.data.total,
+        limit: response.data.limit,
+        offset: response.data.offset,
+        hasMore: response.data.offset + results.length < response.data.total,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwEH;;GAEG;AACH,SAAS,cAAc,CAAC,GAAqB;IAC3C,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE;YACN,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU;SACjC;QACD,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,YAAY;YAC3B,CAAC,CAAC;gBACE,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,aAAa;aAC7C;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,OAAsB;IAEtB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE/B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACpF,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAoB,iBAAiB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE3F,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAExD,OAAO;QACL,OAAO;QACP,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;QAC1B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK;QAC1B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QAC5B,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK;KACrE,CAAC;AACJ,CAAC"}