@googleapis/agentregistry 1.0.0 → 2.0.0

package/build/v1alpha.d.ts

@@ -70,6 +70,31 @@ export declare namespace agentregistry_v1alpha {
         projects: Resource$Projects;
         constructor(options: GlobalOptions, google?: GoogleConfigurable);
     }
+    /**
+     * Represents the skills of an Agent.
+     */
+    export interface Schema$A2ASkill {
+        /**
+         * Output only. A more detailed description of the skill.
+         */
+        description?: string | null;
+        /**
+         * Output only. Example prompts or scenarios this skill can handle.
+         */
+        examples?: string[] | null;
+        /**
+         * Output only. A unique identifier for the agent's skill.
+         */
+        id?: string | null;
+        /**
+         * Output only. A human-readable name for the agent's skill.
+         */
+        name?: string | null;
+        /**
+         * Output only. Keywords describing the skill.
+         */
+        tags?: string[] | null;
+    }
     /**
      * Represents an Agent. "A2A" below refers to the Agent-to-Agent protocol.
      */
@@ -117,7 +142,7 @@ export declare namespace agentregistry_v1alpha {
         /**
          * Output only. Skills the agent possesses, often obtained from the A2A Agent Card.
          */
-        skills?: Schema$Skill[];
+        skills?: Schema$A2ASkill[];
         /**
          * Output only. A universally unique identifier for the Agent.
          */
@@ -171,6 +196,15 @@ export declare namespace agentregistry_v1alpha {
          */
         title?: string | null;
     }
+    /**
+     * Direct write-only raw archive payload upload.
+     */
+    export interface Schema$ArchiveUploadSource {
+        /**
+         * Required. Input only. Write-only raw ZIP/TAR archive payload bytes containing the skill package.
+         */
+        archiveContent?: string | null;
+    }
     /**
      * The AuthProvider of the Binding.
      */
@@ -319,6 +353,46 @@ export declare namespace agentregistry_v1alpha {
          */
         nextPageToken?: string | null;
     }
+    /**
+     * Structured metadata attributes extracted from the package's local SKILL.md frontmatter.
+     */
+    export interface Schema$Frontmatter {
+        /**
+         * Optional. Environmental dependencies or local sidecars.
+         */
+        compatibility?: string | null;
+        /**
+         * Required. Functional description.
+         */
+        description?: string | null;
+        /**
+         * Optional. License.
+         */
+        license?: string | null;
+        /**
+         * Optional. Extensible flattened map mapping custom tags, authors, and version parameters.
+         */
+        metadata?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Required. The name of the skill.
+         */
+        name?: string | null;
+    }
+    /**
+     * Specifications for Cloud Storage objects.
+     */
+    export interface Schema$GcsSource {
+        /**
+         * Optional. Cloud Storage object generation ID. If not specified, the latest generation is used.
+         */
+        generation?: string | null;
+        /**
+         * Required. Cloud Storage object URI. Format: `gs://{bucket_name\}/{object_name\}`
+         */
+        uri?: string | null;
+    }
     /**
      * Represents the connection details for an Agent or MCP Server.
      */
@@ -414,6 +488,19 @@ export declare namespace agentregistry_v1alpha {
          */
         unreachable?: string[] | null;
     }
+    /**
+     * Response listing Publishers.
+     */
+    export interface Schema$ListPublishersResponse {
+        /**
+         * Page offset continuation token.
+         */
+        nextPageToken?: string | null;
+        /**
+         * The returned list of Publishers.
+         */
+        publishers?: Schema$Publisher[];
+    }
     /**
      * Message for response to listing Services
      */
@@ -427,6 +514,36 @@ export declare namespace agentregistry_v1alpha {
          */
         services?: Schema$Service[];
     }
+    /**
+     * Response listing Revisions.
+     */
+    export interface Schema$ListSkillRevisionsResponse {
+        /**
+         * Page offset continuation token.
+         */
+        nextPageToken?: string | null;
+        /**
+         * Returned version snapshot list.
+         */
+        skillRevisions?: Schema$SkillRevision[];
+    }
+    /**
+     * Response structure listing logical Skills.
+     */
+    export interface Schema$ListSkillsResponse {
+        /**
+         * Page continuation continuation token.
+         */
+        nextPageToken?: string | null;
+        /**
+         * Returned container list.
+         */
+        skills?: Schema$Skill[];
+        /**
+         * Unreachable locations or failures.
+         */
+        unreachable?: string[] | null;
+    }
     /**
      * A resource that represents a Google Cloud location.
      */
@@ -595,6 +712,35 @@ export declare namespace agentregistry_v1alpha {
          */
         type?: string | null;
     }
+    /**
+     * Represents a verified Publisher of Skills. Prepopulated publishers include `publishers/cloud.google.com` and `publishers/workspace.google.com`.
+     */
+    export interface Schema$Publisher {
+        /**
+         * Optional. Human readable display name of the publisher.
+         */
+        displayName?: string | null;
+        /**
+         * Optional. URI pointing to official publisher documentation.
+         */
+        documentationUri?: string | null;
+        /**
+         * Identifier. Resource name of the publisher. Format: `projects/{project\}/locations/{location\}/publishers/{publisher\}`
+         */
+        name?: string | null;
+        /**
+         * Output only. The curation tier of the publisher.
+         */
+        publisherTier?: string | null;
+        /**
+         * Optional. URI pointing to the support portal or email.
+         */
+        supportUri?: string | null;
+        /**
+         * Required. The verified prefix (e.g. "snowflake-", "google-") associated with this publisher. The system uses this prefix to enforce name-squatting rules during Skill registration. Must be globally unique across all publishers.
+         */
+        verifiedPrefix?: string | null;
+    }
     /**
      * Message for searching Agents
      */
@@ -655,6 +801,19 @@ export declare namespace agentregistry_v1alpha {
          */
         nextPageToken?: string | null;
     }
+    /**
+     * Response listing searched Skills.
+     */
+    export interface Schema$SearchSkillsResponse {
+        /**
+         * Query page offset continuation token.
+         */
+        nextPageToken?: string | null;
+        /**
+         * Matched Skills list.
+         */
+        skills?: Schema$Skill[];
+    }
     /**
      * Represents a user-defined Service.
      */
@@ -701,29 +860,106 @@ export declare namespace agentregistry_v1alpha {
         updateTime?: string | null;
     }
     /**
-     * Represents the skills of an Agent.
+     * Represents an Executable Agent Skill or a Composite Tool Suite (Bundle). Sibling resource with Agent and McpServer under agentregistry.googleapis.com.
      */
     export interface Schema$Skill {
         /**
-         * Output only. A more detailed description of the skill.
+         * Output only. Create time.
+         */
+        createTime?: string | null;
+        /**
+         * Optional. The full resource name of the revision currently served by default (floating track). Format: `projects/{project\}/locations/{location\}/skills/{skill\}/revisions/{revision\}`
+         */
+        defaultRevision?: string | null;
+        /**
+         * Optional. Brief summary describing the capabilities of the skill. Maximum length is 2048 characters.
          */
         description?: string | null;
         /**
-         * Output only. Example prompts or scenarios this skill can handle.
+         * Required. Human-readable display name of the skill. Maximum length is 128 characters.
          */
-        examples?: string[] | null;
+        displayName?: string | null;
         /**
-         * Output only. A unique identifier for the agent's skill.
+         * Output only. Lightweight frontmatter metadata attributes copied from the default revision.
          */
-        id?: string | null;
+        frontmatter?: Schema$Frontmatter;
         /**
-         * Output only. A human-readable name for the agent's skill.
+         * Optional. Input only. Optional nested initial revision payload to support standard one-shot creation. The server processes this field on input during creation but must never return it in responses.
+         */
+        initialRevision?: Schema$SkillRevision;
+        /**
+         * Identifier. Resource name of the Skill. Format: `projects/{project\}/locations/{location\}/skills/{skill\}` The `{skill\}` segment acts as the resource ID. If the skill is associated with a Publisher, this segment typically uses a hyphenated namespace prefix corresponding to the publisher (e.g., `google-workspace-create-docs`).
          */
         name?: string | null;
         /**
-         * Output only. Keywords describing the skill.
+         * Optional. The publisher resource associated with this skill. Format: `projects/{project\}/locations/{location\}/publishers/{publisher\}` The publisher dictates the allowed namespace prefixes for the skill's name and logical `skill_id` (e.g., Publisher `google` authorizes the `google-*` prefix).
          */
-        tags?: string[] | null;
+        publisher?: string | null;
+        /**
+         * Output only. A stable, globally unique logical identifier for the skill. It is securely constructed by the backend by combining the associated `publisher`'s verified namespace and the skill's resource ID to enforce strict ownership. For example, the prefix `google-` is reserved exclusively for first-party Google publishers to prevent namespace squatting. Example: `urn:skill:google-workspace:create-docs`
+         */
+        skillId?: string | null;
+        /**
+         * Output only. The system-managed state of the skill.
+         */
+        state?: string | null;
+        /**
+         * Required. User-managed target state of the skill.
+         */
+        targetState?: string | null;
+        /**
+         * Required. Structural deployment type (SIMPLE leaf vs COMPOSITE bundle).
+         */
+        type?: string | null;
+        /**
+         * Output only. Universally unique identifier (UUID4) for the logical container.
+         */
+        uid?: string | null;
+        /**
+         * Output only. Update time.
+         */
+        updateTime?: string | null;
+    }
+    /**
+     * Represents an immutable, versioned snapshot of a Skill package.
+     */
+    export interface Schema$SkillRevision {
+        /**
+         * Optional. Immutable. Direct write-only raw archive upload source.
+         */
+        archiveUploadSource?: Schema$ArchiveUploadSource;
+        /**
+         * Output only. Revision creation timestamp.
+         */
+        createTime?: string | null;
+        /**
+         * Output only. Extracted YAML frontmatter configuration snapshot.
+         */
+        frontmatter?: Schema$Frontmatter;
+        /**
+         * Optional. Immutable. Cloud Storage object generation URI.
+         */
+        gcsSource?: Schema$GcsSource;
+        /**
+         * Identifier. Resource name of the SkillRevision. Format: `projects/{project\}/locations/{location\}/skills/{skill\}/revisions/{revision\}`
+         */
+        name?: string | null;
+        /**
+         * Output only. Cryptographic SHA-256 integrity and deduplication digest of the payload zip.
+         */
+        sha256Hash?: string | null;
+        /**
+         * Output only. Size of the compiled zip payload in bytes (assists client download progress).
+         */
+        sizeBytes?: string | null;
+        /**
+         * Output only. The system-managed lifecycle state of this revision.
+         */
+        state?: string | null;
+        /**
+         * Output only. Universally unique identifier (UUID4) for the skill revision.
+         */
+        uid?: string | null;
     }
     /**
      * The source of the Binding.
@@ -791,7 +1027,9 @@ export declare namespace agentregistry_v1alpha {
         endpoints: Resource$Projects$Locations$Endpoints;
         mcpServers: Resource$Projects$Locations$Mcpservers;
         operations: Resource$Projects$Locations$Operations;
+        publishers: Resource$Projects$Locations$Publishers;
         services: Resource$Projects$Locations$Services;
+        skills: Resource$Projects$Locations$Skills;
         constructor(context: APIRequestContext);
         /**
          * Gets information about a location.
@@ -1256,8 +1494,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -1342,8 +1582,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -1631,8 +1873,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -2546,11 +2790,11 @@ export declare namespace agentregistry_v1alpha {
          */
         returnPartialSuccess?: boolean;
     }
-    export class Resource$Projects$Locations$Services {
+    export class Resource$Projects$Locations$Publishers {
         context: APIRequestContext;
         constructor(context: APIRequestContext);
         /**
-         * Creates a new Service in a given project and location.
+         * Fetches details of a specific Publisher.
          * @example
          * ```js
          * // Before running the sample:
@@ -2572,8 +2816,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -2582,40 +2828,20 @@ export declare namespace agentregistry_v1alpha {
          *   google.options({auth: authClient});
          *
          *   // Do the magic
-         *   const res = await agentregistry.projects.locations.services.create({
-         *     // Required. The project and location to create the Service in. Expected format: `projects/{project\}/locations/{location\}`.
-         *     parent: 'projects/my-project/locations/my-location',
-         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
-         *     requestId: 'placeholder-value',
-         *     // Required. The ID to use for the service, which will become the final component of the service's resource name. This value should be 4-63 characters, and valid characters are `/a-z-/`.
-         *     serviceId: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "agentSpec": {},
-         *       //   "createTime": "my_createTime",
-         *       //   "description": "my_description",
-         *       //   "displayName": "my_displayName",
-         *       //   "endpointSpec": {},
-         *       //   "interfaces": [],
-         *       //   "mcpServerSpec": {},
-         *       //   "name": "my_name",
-         *       //   "registryResource": "my_registryResource",
-         *       //   "updateTime": "my_updateTime"
-         *       // }
-         *     },
+         *   const res = await agentregistry.projects.locations.publishers.get({
+         *     // Required. Target publisher resource name. Format: `projects/{project\}/locations/{location\}/publishers/{publisher\}`
+         *     name: 'projects/my-project/locations/my-location/publishers/my-publisher',
          *   });
          *   console.log(res.data);
          *
          *   // Example response
          *   // {
-         *   //   "done": false,
-         *   //   "error": {},
-         *   //   "metadata": {},
+         *   //   "displayName": "my_displayName",
+         *   //   "documentationUri": "my_documentationUri",
          *   //   "name": "my_name",
-         *   //   "response": {}
+         *   //   "publisherTier": "my_publisherTier",
+         *   //   "supportUri": "my_supportUri",
+         *   //   "verifiedPrefix": "my_verifiedPrefix"
          *   // }
          * }
          *
@@ -2631,14 +2857,14 @@ export declare namespace agentregistry_v1alpha {
          * @param callback - Optional callback that handles the response.
          * @returns A promise if used with async/await, or void if used with a callback.
          */
-        create(params: Params$Resource$Projects$Locations$Services$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
-        create(params?: Params$Resource$Projects$Locations$Services$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
-        create(params: Params$Resource$Projects$Locations$Services$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
-        create(params: Params$Resource$Projects$Locations$Services$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
-        create(params: Params$Resource$Projects$Locations$Services$Create, callback: BodyResponseCallback<Schema$Operation>): void;
-        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        get(params: Params$Resource$Projects$Locations$Publishers$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        get(params?: Params$Resource$Projects$Locations$Publishers$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Publisher>>;
+        get(params: Params$Resource$Projects$Locations$Publishers$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        get(params: Params$Resource$Projects$Locations$Publishers$Get, options: MethodOptions | BodyResponseCallback<Schema$Publisher>, callback: BodyResponseCallback<Schema$Publisher>): void;
+        get(params: Params$Resource$Projects$Locations$Publishers$Get, callback: BodyResponseCallback<Schema$Publisher>): void;
+        get(callback: BodyResponseCallback<Schema$Publisher>): void;
         /**
-         * Deletes a single Service.
+         * Lists all Publishers in a location.
          * @example
          * ```js
          * // Before running the sample:
@@ -2660,8 +2886,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -2670,21 +2898,20 @@ export declare namespace agentregistry_v1alpha {
          *   google.options({auth: authClient});
          *
          *   // Do the magic
-         *   const res = await agentregistry.projects.locations.services.delete({
-         *     // Required. The name of the Service. Format: `projects/{project\}/locations/{location\}/services/{service\}`.
-         *     name: 'projects/my-project/locations/my-location/services/my-service',
-         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
-         *     requestId: 'placeholder-value',
+         *   const res = await agentregistry.projects.locations.publishers.list({
+         *     // Optional. Page limit size.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. Page offset token.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent location to query. Format: `projects/{project\}/locations/{location\}`
+         *     parent: 'projects/my-project/locations/my-location',
          *   });
          *   console.log(res.data);
          *
          *   // Example response
          *   // {
-         *   //   "done": false,
-         *   //   "error": {},
-         *   //   "metadata": {},
-         *   //   "name": "my_name",
-         *   //   "response": {}
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "publishers": []
          *   // }
          * }
          *
@@ -2700,14 +2927,38 @@ export declare namespace agentregistry_v1alpha {
          * @param callback - Optional callback that handles the response.
          * @returns A promise if used with async/await, or void if used with a callback.
          */
-        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
-        delete(params?: Params$Resource$Projects$Locations$Services$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
-        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
-        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
-        delete(params: Params$Resource$Projects$Locations$Services$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
-        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        list(params: Params$Resource$Projects$Locations$Publishers$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        list(params?: Params$Resource$Projects$Locations$Publishers$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListPublishersResponse>>;
+        list(params: Params$Resource$Projects$Locations$Publishers$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        list(params: Params$Resource$Projects$Locations$Publishers$List, options: MethodOptions | BodyResponseCallback<Schema$ListPublishersResponse>, callback: BodyResponseCallback<Schema$ListPublishersResponse>): void;
+        list(params: Params$Resource$Projects$Locations$Publishers$List, callback: BodyResponseCallback<Schema$ListPublishersResponse>): void;
+        list(callback: BodyResponseCallback<Schema$ListPublishersResponse>): void;
+    }
+    export interface Params$Resource$Projects$Locations$Publishers$Get extends StandardParameters {
         /**
-         * Gets details of a single Service.
+         * Required. Target publisher resource name. Format: `projects/{project\}/locations/{location\}/publishers/{publisher\}`
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Publishers$List extends StandardParameters {
+        /**
+         * Optional. Page limit size.
+         */
+        pageSize?: number;
+        /**
+         * Optional. Page offset token.
+         */
+        pageToken?: string;
+        /**
+         * Required. Parent location to query. Format: `projects/{project\}/locations/{location\}`
+         */
+        parent?: string;
+    }
+    export class Resource$Projects$Locations$Services {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Creates a new Service in a given project and location.
          * @example
          * ```js
          * // Before running the sample:
@@ -2741,7 +2992,168 @@ export declare namespace agentregistry_v1alpha {
          *   google.options({auth: authClient});
          *
          *   // Do the magic
-         *   const res = await agentregistry.projects.locations.services.get({
+         *   const res = await agentregistry.projects.locations.services.create({
+         *     // Required. The project and location to create the Service in. Expected format: `projects/{project\}/locations/{location\}`.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *     // Required. The ID to use for the service, which will become the final component of the service's resource name. This value should be 4-63 characters, and valid characters are `/a-z-/`.
+         *     serviceId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "agentSpec": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "description": "my_description",
+         *       //   "displayName": "my_displayName",
+         *       //   "endpointSpec": {},
+         *       //   "interfaces": [],
+         *       //   "mcpServerSpec": {},
+         *       //   "name": "my_name",
+         *       //   "registryResource": "my_registryResource",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        create(params: Params$Resource$Projects$Locations$Services$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        create(params?: Params$Resource$Projects$Locations$Services$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        create(params: Params$Resource$Projects$Locations$Services$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        create(params: Params$Resource$Projects$Locations$Services$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(params: Params$Resource$Projects$Locations$Services$Create, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Deletes a single Service.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.services.delete({
+         *     // Required. The name of the Service. Format: `projects/{project\}/locations/{location\}/services/{service\}`.
+         *     name: 'projects/my-project/locations/my-location/services/my-service',
+         *     // Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+         *     requestId: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        delete(params?: Params$Resource$Projects$Locations$Services$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        delete(params: Params$Resource$Projects$Locations$Services$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(params: Params$Resource$Projects$Locations$Services$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Gets details of a single Service.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.services.get({
          *     // Required. The name of the Service. Format: `projects/{project\}/locations/{location\}/services/{service\}`.
          *     name: 'projects/my-project/locations/my-location/services/my-service',
          *   });
@@ -2875,8 +3287,10 @@ export declare namespace agentregistry_v1alpha {
          *   const auth = new google.auth.GoogleAuth({
          *     // Scopes can be specified either as an array or as a single, space-delimited string.
          *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
          *       'https://www.googleapis.com/auth/agentregistry.read-write',
          *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
          *     ],
          *   });
          *
@@ -3011,5 +3425,959 @@ export declare namespace agentregistry_v1alpha {
          */
         requestBody?: Schema$Service;
     }
+    export class Resource$Projects$Locations$Skills {
+        context: APIRequestContext;
+        revisions: Resource$Projects$Locations$Skills$Revisions;
+        constructor(context: APIRequestContext);
+        /**
+         * ========================================================================= # Skills Collection APIs Creates a Skill resource container, optionally publishing the initial SkillRevision inline in a single, atomic CRUD roundtrip.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.create({
+         *     // Required. The project and location location to bootstrap.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. Signed UUID request idempotency token.
+         *     requestId: 'placeholder-value',
+         *     // Required. Custom, user-defined unique container identifier. Must be unique within the parent project and location. This value should be 4-63 characters, and valid characters are `/a-z-/`.
+         *     skillId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "createTime": "my_createTime",
+         *       //   "defaultRevision": "my_defaultRevision",
+         *       //   "description": "my_description",
+         *       //   "displayName": "my_displayName",
+         *       //   "frontmatter": {},
+         *       //   "initialRevision": {},
+         *       //   "name": "my_name",
+         *       //   "publisher": "my_publisher",
+         *       //   "skillId": "my_skillId",
+         *       //   "state": "my_state",
+         *       //   "targetState": "my_targetState",
+         *       //   "type": "my_type",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        create(params: Params$Resource$Projects$Locations$Skills$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        create(params?: Params$Resource$Projects$Locations$Skills$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        create(params: Params$Resource$Projects$Locations$Skills$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        create(params: Params$Resource$Projects$Locations$Skills$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(params: Params$Resource$Projects$Locations$Skills$Create, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Deletes a Skill container along with all its revisions.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.delete({
+         *     // Optional. If set to true, any child SkillRevisions under this Skill will also be deleted. Otherwise, the request will only succeed if the Skill has no child SkillRevisions.
+         *     force: 'placeholder-value',
+         *     // Required. Target Skill container name to remove.
+         *     name: 'projects/my-project/locations/my-location/skills/my-skill',
+         *     // Optional. Signed UUID request idempotency token.
+         *     requestId: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        delete(params: Params$Resource$Projects$Locations$Skills$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        delete(params?: Params$Resource$Projects$Locations$Skills$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        delete(params: Params$Resource$Projects$Locations$Skills$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        delete(params: Params$Resource$Projects$Locations$Skills$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(params: Params$Resource$Projects$Locations$Skills$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Fetches the active configuration and metadata of a Skill.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.get({
+         *     // Required. Target resource container name.
+         *     name: 'projects/my-project/locations/my-location/skills/my-skill',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "createTime": "my_createTime",
+         *   //   "defaultRevision": "my_defaultRevision",
+         *   //   "description": "my_description",
+         *   //   "displayName": "my_displayName",
+         *   //   "frontmatter": {},
+         *   //   "initialRevision": {},
+         *   //   "name": "my_name",
+         *   //   "publisher": "my_publisher",
+         *   //   "skillId": "my_skillId",
+         *   //   "state": "my_state",
+         *   //   "targetState": "my_targetState",
+         *   //   "type": "my_type",
+         *   //   "uid": "my_uid",
+         *   //   "updateTime": "my_updateTime"
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        get(params: Params$Resource$Projects$Locations$Skills$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        get(params?: Params$Resource$Projects$Locations$Skills$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Skill>>;
+        get(params: Params$Resource$Projects$Locations$Skills$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        get(params: Params$Resource$Projects$Locations$Skills$Get, options: MethodOptions | BodyResponseCallback<Schema$Skill>, callback: BodyResponseCallback<Schema$Skill>): void;
+        get(params: Params$Resource$Projects$Locations$Skills$Get, callback: BodyResponseCallback<Schema$Skill>): void;
+        get(callback: BodyResponseCallback<Schema$Skill>): void;
+        /**
+         * Lists logical Skills available in a project.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.list({
+         *     // Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
+         *     filter: 'placeholder-value',
+         *     // Optional. Hint for how to order the results
+         *     orderBy: 'placeholder-value',
+         *     // Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. A token identifying a page of results the server should return.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent value for ListSkillsRequest
+         *     parent: 'projects/my-project/locations/my-location',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "skills": [],
+         *   //   "unreachable": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        list(params: Params$Resource$Projects$Locations$Skills$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        list(params?: Params$Resource$Projects$Locations$Skills$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListSkillsResponse>>;
+        list(params: Params$Resource$Projects$Locations$Skills$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        list(params: Params$Resource$Projects$Locations$Skills$List, options: MethodOptions | BodyResponseCallback<Schema$ListSkillsResponse>, callback: BodyResponseCallback<Schema$ListSkillsResponse>): void;
+        list(params: Params$Resource$Projects$Locations$Skills$List, callback: BodyResponseCallback<Schema$ListSkillsResponse>): void;
+        list(callback: BodyResponseCallback<Schema$ListSkillsResponse>): void;
+        /**
+         * Updates Skill metadata or overrides active pointers/state using REST standard PATCH.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.patch({
+         *     // Identifier. Resource name of the Skill. Format: `projects/{project\}/locations/{location\}/skills/{skill\}` The `{skill\}` segment acts as the resource ID. If the skill is associated with a Publisher, this segment typically uses a hyphenated namespace prefix corresponding to the publisher (e.g., `google-workspace-create-docs`).
+         *     name: 'projects/my-project/locations/my-location/skills/my-skill',
+         *     // Optional. Signed UUID request idempotency token.
+         *     requestId: 'placeholder-value',
+         *     // Optional. Standard update target mask mapping relative fields.
+         *     updateMask: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "createTime": "my_createTime",
+         *       //   "defaultRevision": "my_defaultRevision",
+         *       //   "description": "my_description",
+         *       //   "displayName": "my_displayName",
+         *       //   "frontmatter": {},
+         *       //   "initialRevision": {},
+         *       //   "name": "my_name",
+         *       //   "publisher": "my_publisher",
+         *       //   "skillId": "my_skillId",
+         *       //   "state": "my_state",
+         *       //   "targetState": "my_targetState",
+         *       //   "type": "my_type",
+         *       //   "uid": "my_uid",
+         *       //   "updateTime": "my_updateTime"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        patch(params: Params$Resource$Projects$Locations$Skills$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        patch(params?: Params$Resource$Projects$Locations$Skills$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        patch(params: Params$Resource$Projects$Locations$Skills$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        patch(params: Params$Resource$Projects$Locations$Skills$Patch, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(params: Params$Resource$Projects$Locations$Skills$Patch, callback: BodyResponseCallback<Schema$Operation>): void;
+        patch(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Custom deep-search method to filter by frontmatter or query SKILL.md text blobs.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.search({
+         *     // Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
+         *     filter: 'placeholder-value',
+         *     // Optional. The maximum number of search results to return per page. The page size is capped at `100`, even if a larger value is specified. A negative value will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a default value of `20` will be used. The server may return fewer results than requested.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. If present, retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of all other method parameters, must be identical to those in the previous call.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent value for SearchSkillsRequest. Format: `projects/{project\}/locations/{location\}`.
+         *     parent: 'projects/my-project/locations/my-location',
+         *     // Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.
+         *     searchString: 'placeholder-value',
+         *     // Optional. The type of search.
+         *     searchType: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "skills": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        search(params: Params$Resource$Projects$Locations$Skills$Search, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        search(params?: Params$Resource$Projects$Locations$Skills$Search, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$SearchSkillsResponse>>;
+        search(params: Params$Resource$Projects$Locations$Skills$Search, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        search(params: Params$Resource$Projects$Locations$Skills$Search, options: MethodOptions | BodyResponseCallback<Schema$SearchSkillsResponse>, callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
+        search(params: Params$Resource$Projects$Locations$Skills$Search, callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
+        search(callback: BodyResponseCallback<Schema$SearchSkillsResponse>): void;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Create extends StandardParameters {
+        /**
+         * Required. The project and location location to bootstrap.
+         */
+        parent?: string;
+        /**
+         * Optional. Signed UUID request idempotency token.
+         */
+        requestId?: string;
+        /**
+         * Required. Custom, user-defined unique container identifier. Must be unique within the parent project and location. This value should be 4-63 characters, and valid characters are `/a-z-/`.
+         */
+        skillId?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$Skill;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Delete extends StandardParameters {
+        /**
+         * Optional. If set to true, any child SkillRevisions under this Skill will also be deleted. Otherwise, the request will only succeed if the Skill has no child SkillRevisions.
+         */
+        force?: boolean;
+        /**
+         * Required. Target Skill container name to remove.
+         */
+        name?: string;
+        /**
+         * Optional. Signed UUID request idempotency token.
+         */
+        requestId?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Get extends StandardParameters {
+        /**
+         * Required. Target resource container name.
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$List extends StandardParameters {
+        /**
+         * Optional. Use this field to specify filter criteria on list results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
+         */
+        filter?: string;
+        /**
+         * Optional. Hint for how to order the results
+         */
+        orderBy?: string;
+        /**
+         * Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+         */
+        pageSize?: number;
+        /**
+         * Optional. A token identifying a page of results the server should return.
+         */
+        pageToken?: string;
+        /**
+         * Required. Parent value for ListSkillsRequest
+         */
+        parent?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Patch extends StandardParameters {
+        /**
+         * Identifier. Resource name of the Skill. Format: `projects/{project\}/locations/{location\}/skills/{skill\}` The `{skill\}` segment acts as the resource ID. If the skill is associated with a Publisher, this segment typically uses a hyphenated namespace prefix corresponding to the publisher (e.g., `google-workspace-create-docs`).
+         */
+        name?: string;
+        /**
+         * Optional. Signed UUID request idempotency token.
+         */
+        requestId?: string;
+        /**
+         * Optional. Standard update target mask mapping relative fields.
+         */
+        updateMask?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$Skill;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Search extends StandardParameters {
+        /**
+         * Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `\>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `\>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.
+         */
+        filter?: string;
+        /**
+         * Optional. The maximum number of search results to return per page. The page size is capped at `100`, even if a larger value is specified. A negative value will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a default value of `20` will be used. The server may return fewer results than requested.
+         */
+        pageSize?: number;
+        /**
+         * Optional. If present, retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of all other method parameters, must be identical to those in the previous call.
+         */
+        pageToken?: string;
+        /**
+         * Required. Parent value for SearchSkillsRequest. Format: `projects/{project\}/locations/{location\}`.
+         */
+        parent?: string;
+        /**
+         * Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId="urn:skill:projects-1234:locations:global:private-important-skill"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.
+         */
+        searchString?: string;
+        /**
+         * Optional. The type of search.
+         */
+        searchType?: string;
+    }
+    export class Resource$Projects$Locations$Skills$Revisions {
+        context: APIRequestContext;
+        constructor(context: APIRequestContext);
+        /**
+         * Creates a new immutable revision and triggers validation pipelines.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.revisions.create({
+         *     // Required. Parent logical container name.
+         *     parent: 'projects/my-project/locations/my-location/skills/my-skill',
+         *     // Optional. Signed UUID request idempotency token.
+         *     requestId: 'placeholder-value',
+         *     // Optional. Custom, user-defined unique revision identifier. Format: 4-63 characters, matching regex `^[a-z]([a-z0-9-]{0,61\}[a-z0-9])?$`
+         *     skillRevisionId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "archiveUploadSource": {},
+         *       //   "createTime": "my_createTime",
+         *       //   "frontmatter": {},
+         *       //   "gcsSource": {},
+         *       //   "name": "my_name",
+         *       //   "sha256Hash": "my_sha256Hash",
+         *       //   "sizeBytes": "my_sizeBytes",
+         *       //   "state": "my_state",
+         *       //   "uid": "my_uid"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        create(params: Params$Resource$Projects$Locations$Skills$Revisions$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        create(params?: Params$Resource$Projects$Locations$Skills$Revisions$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        create(params: Params$Resource$Projects$Locations$Skills$Revisions$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        create(params: Params$Resource$Projects$Locations$Skills$Revisions$Create, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(params: Params$Resource$Projects$Locations$Skills$Revisions$Create, callback: BodyResponseCallback<Schema$Operation>): void;
+        create(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Deletes a specific revision (restricted to admins to purge accidentally committed secrets).
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.revisions.delete({
+         *     // Required. Target revision name to remove.
+         *     name: 'projects/my-project/locations/my-location/skills/my-skill/revisions/my-revision',
+         *     // Optional. Signed UUID request idempotency token.
+         *     requestId: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "done": false,
+         *   //   "error": {},
+         *   //   "metadata": {},
+         *   //   "name": "my_name",
+         *   //   "response": {}
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        delete(params: Params$Resource$Projects$Locations$Skills$Revisions$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        delete(params?: Params$Resource$Projects$Locations$Skills$Revisions$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
+        delete(params: Params$Resource$Projects$Locations$Skills$Revisions$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        delete(params: Params$Resource$Projects$Locations$Skills$Revisions$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(params: Params$Resource$Projects$Locations$Skills$Revisions$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
+        delete(callback: BodyResponseCallback<Schema$Operation>): void;
+        /**
+         * Gets details of a single immutable Revision.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.revisions.get({
+         *     // Required. Target revision name.
+         *     name: 'projects/my-project/locations/my-location/skills/my-skill/revisions/my-revision',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "archiveUploadSource": {},
+         *   //   "createTime": "my_createTime",
+         *   //   "frontmatter": {},
+         *   //   "gcsSource": {},
+         *   //   "name": "my_name",
+         *   //   "sha256Hash": "my_sha256Hash",
+         *   //   "sizeBytes": "my_sizeBytes",
+         *   //   "state": "my_state",
+         *   //   "uid": "my_uid"
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        get(params: Params$Resource$Projects$Locations$Skills$Revisions$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        get(params?: Params$Resource$Projects$Locations$Skills$Revisions$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$SkillRevision>>;
+        get(params: Params$Resource$Projects$Locations$Skills$Revisions$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        get(params: Params$Resource$Projects$Locations$Skills$Revisions$Get, options: MethodOptions | BodyResponseCallback<Schema$SkillRevision>, callback: BodyResponseCallback<Schema$SkillRevision>): void;
+        get(params: Params$Resource$Projects$Locations$Skills$Revisions$Get, callback: BodyResponseCallback<Schema$SkillRevision>): void;
+        get(callback: BodyResponseCallback<Schema$SkillRevision>): void;
+        /**
+         * Lists all revisions belonging to a parent Skill.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/agentregistry.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const agentregistry = google.agentregistry('v1alpha');
+         *
+         * async function main() {
+         *   const auth = new google.auth.GoogleAuth({
+         *     // Scopes can be specified either as an array or as a single, space-delimited string.
+         *     scopes: [
+         *       'https://www.googleapis.com/auth/agentregistry.read-only',
+         *       'https://www.googleapis.com/auth/agentregistry.read-write',
+         *       'https://www.googleapis.com/auth/cloud-platform',
+         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
+         *     ],
+         *   });
+         *
+         *   // Acquire an auth client, and bind it to all future calls
+         *   const authClient = await auth.getClient();
+         *   google.options({auth: authClient});
+         *
+         *   // Do the magic
+         *   const res = await agentregistry.projects.locations.skills.revisions.list({
+         *     // Optional. Page limit size.
+         *     pageSize: 'placeholder-value',
+         *     // Optional. Page offset token.
+         *     pageToken: 'placeholder-value',
+         *     // Required. Parent logical container name to query.
+         *     parent: 'projects/my-project/locations/my-location/skills/my-skill',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "nextPageToken": "my_nextPageToken",
+         *   //   "skillRevisions": []
+         *   // }
+         * }
+         *
+         * main().catch(e => {
+         *   console.error(e);
+         *   throw e;
+         * });
+         *
+         * ```
+         *
+         * @param params - Parameters for request
+         * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
+         * @param callback - Optional callback that handles the response.
+         * @returns A promise if used with async/await, or void if used with a callback.
+         */
+        list(params: Params$Resource$Projects$Locations$Skills$Revisions$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
+        list(params?: Params$Resource$Projects$Locations$Skills$Revisions$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListSkillRevisionsResponse>>;
+        list(params: Params$Resource$Projects$Locations$Skills$Revisions$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
+        list(params: Params$Resource$Projects$Locations$Skills$Revisions$List, options: MethodOptions | BodyResponseCallback<Schema$ListSkillRevisionsResponse>, callback: BodyResponseCallback<Schema$ListSkillRevisionsResponse>): void;
+        list(params: Params$Resource$Projects$Locations$Skills$Revisions$List, callback: BodyResponseCallback<Schema$ListSkillRevisionsResponse>): void;
+        list(callback: BodyResponseCallback<Schema$ListSkillRevisionsResponse>): void;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Revisions$Create extends StandardParameters {
+        /**
+         * Required. Parent logical container name.
+         */
+        parent?: string;
+        /**
+         * Optional. Signed UUID request idempotency token.
+         */
+        requestId?: string;
+        /**
+         * Optional. Custom, user-defined unique revision identifier. Format: 4-63 characters, matching regex `^[a-z]([a-z0-9-]{0,61\}[a-z0-9])?$`
+         */
+        skillRevisionId?: string;
+        /**
+         * Request body metadata
+         */
+        requestBody?: Schema$SkillRevision;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Revisions$Delete extends StandardParameters {
+        /**
+         * Required. Target revision name to remove.
+         */
+        name?: string;
+        /**
+         * Optional. Signed UUID request idempotency token.
+         */
+        requestId?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Revisions$Get extends StandardParameters {
+        /**
+         * Required. Target revision name.
+         */
+        name?: string;
+    }
+    export interface Params$Resource$Projects$Locations$Skills$Revisions$List extends StandardParameters {
+        /**
+         * Optional. Page limit size.
+         */
+        pageSize?: number;
+        /**
+         * Optional. Page offset token.
+         */
+        pageToken?: string;
+        /**
+         * Required. Parent logical container name to query.
+         */
+        parent?: string;
+    }
     export {};
 }