@google-cloud/agentregistry 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+[//]: # "This README.md file is auto-generated, all changes to this file will be lost."
+[//]: # "The comments you see below are used to generate those parts of the template in later states."
+<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
+
+# [Agent Registry API: Nodejs Client][homepage]
+
+[//]: # "releaseLevel"
+
+[![npm version](https://img.shields.io/npm/v/@google-cloud/agentregistry.svg)](https://www.npmjs.org/package/@google-cloud/agentregistry)
+
+Agent Registry API client for Node.js
+
+[//]: # "partials.introduction"
+
+A comprehensive list of changes in each version may be found in
+[the CHANGELOG][homepage_changelog].
+
+* [Agent Registry API Nodejs Client API Reference](https://cloud.google.com/nodejs/docs/reference/agentregistry/latest)
+* [Agent Registry API Documentation](https://docs.cloud.google.com/agent-registry/overview)
+
+Read more about the client libraries for Cloud APIs, including the older
+Google APIs Client Libraries, in [Client Libraries Explained][explained].
+
+[explained]: https://cloud.google.com/apis/docs/client-libraries-explained
+
+**Table of contents:**
+
+* [Quickstart](#quickstart)
+  * [Before you begin](#before-you-begin)
+  * [Installing the client library](#installing-the-client-library)
+
+* [Versioning](#versioning)
+* [Contributing](#contributing)
+* [License](#license)
+
+## Quickstart
+### Before you begin
+
+1.  [Select or create a Cloud Platform project][projects].
+1.  [Enable billing for your project][billing].
+1.  [Enable the Agent Registry API API][enable_api].
+1.  [Set up authentication][auth] so you can access the
+    API from your local workstation.
+### Installing the client library
+
+```bash
+npm install @google-cloud/agentregistry
+```
+
+[//]: # "partials.body"
+
+## Samples
+
+Samples are in the [`samples/`][homepage_samples] directory. Each sample's `README.md` has instructions for running its sample.
+
+[//]: # "samples"
+
+## Supported Node.js Versions
+
+Our client libraries follow the [Node.js release schedule](https://github.com/nodejs/release#release-schedule).
+Libraries are compatible with all current _active_ and _maintenance_ versions of
+Node.js.
+If you are using an end-of-life version of Node.js, we recommend that you update
+as soon as possible to an actively supported LTS version.
+
+Google's client libraries support legacy versions of Node.js runtimes on a
+best-efforts basis with the following warnings:
+
+* Legacy versions are not tested in continuous integration.
+* Some security patches and features cannot be backported.
+* Dependencies cannot be kept up-to-date.
+
+Client libraries targeting some end-of-life versions of Node.js are available, and
+can be installed through npm [dist-tags](https://docs.npmjs.com/cli/dist-tag).
+The dist-tags follow the naming convention `legacy-(version)`.
+For example, `npm install @google-cloud/agentregistry@legacy-8` installs client libraries
+for versions compatible with Node.js 8.
+
+## Versioning
+
+This library follows [Semantic Versioning](http://semver.org/).
+
+More Information: [Google Cloud Platform Launch Stages][launch_stages]
+
+[launch_stages]: https://cloud.google.com/terms/launch-stages
+
+## Contributing
+
+Contributions welcome! See the [Contributing Guide](https://github.com/googleapis/google-cloud-node/blob/main/CONTRIBUTING.md).
+
+Please note that this `README.md`
+and a variety of configuration files in this repository (including `.nycrc` and `tsconfig.json`)
+are generated from a central template.
+
+## License
+
+Apache Version 2.0
+
+See [LICENSE](https://github.com/googleapis/google-cloud-node/blob/main/LICENSE)
+
+[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
+[projects]: https://console.cloud.google.com/project
+[billing]: https://support.google.com/cloud/answer/6293499#enable-billing
+[enable_api]: https://console.cloud.google.com/flows/enableapi?apiid=agentregistry.googleapis.com
+[auth]: https://cloud.google.com/docs/authentication/external/set-up-adc-local
+[homepage_samples]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-agentregistry/samples
+[homepage_changelog]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-agentregistry/CHANGELOG.md
+[homepage]: https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-agentregistry

package/build/protos/google/cloud/agentregistry/v1/agent.proto

@@ -0,0 +1,168 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.agentregistry.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/field_info.proto";
+import "google/api/resource.proto";
+import "google/cloud/agentregistry/v1/properties.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.AgentRegistry.V1";
+option go_package = "cloud.google.com/go/agentregistry/apiv1/agentregistrypb;agentregistrypb";
+option java_multiple_files = true;
+option java_outer_classname = "AgentProto";
+option java_package = "com.google.cloud.agentregistry.v1";
+option php_namespace = "Google\\Cloud\\AgentRegistry\\V1";
+option ruby_package = "Google::Cloud::AgentRegistry::V1";
+
+// Represents an Agent.
+// "A2A" below refers to the Agent-to-Agent protocol.
+message Agent {
+  option (google.api.resource) = {
+    type: "agentregistry.googleapis.com/Agent"
+    pattern: "projects/{project}/locations/{location}/agents/{agent}"
+    plural: "agents"
+    singular: "agent"
+  };
+
+  // Represents the protocol of an Agent.
+  message Protocol {
+    // The type of the protocol.
+    enum Type {
+      // Unspecified type.
+      TYPE_UNSPECIFIED = 0;
+
+      // The interfaces point to an A2A Agent following the A2A
+      // specification.
+      A2A_AGENT = 1;
+
+      // Agent does not follow any standard protocol.
+      CUSTOM = 2;
+    }
+
+    // Output only. The type of the protocol.
+    Type type = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The version of the protocol, for example, the A2A Agent Card
+    // version.
+    string protocol_version = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The connection details for the Agent.
+    repeated Interface interfaces = 3
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Represents the skills of an Agent.
+  message Skill {
+    // Output only. A unique identifier for the agent's skill.
+    string id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. A human-readable name for the agent's skill.
+    string name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. A more detailed description of the skill.
+    string description = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Keywords describing the skill.
+    repeated string tags = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Example prompts or scenarios this skill can handle.
+    repeated string examples = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Full Agent Card payload, often obtained from the A2A Agent Card.
+  message Card {
+    // Represents the type of the agent card.
+    enum Type {
+      // Unspecified type.
+      TYPE_UNSPECIFIED = 0;
+
+      // Indicates that the card is an A2A Agent Card.
+      A2A_AGENT_CARD = 1;
+    }
+
+    // Output only. The type of agent card.
+    Type type = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The content of the agent card.
+    google.protobuf.Struct content = 2
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Identifier. The resource name of an Agent.
+  // Format: `projects/{project}/locations/{location}/agents/{agent}`.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Output only. A stable, globally unique identifier for agents.
+  string agent_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The location where agent is hosted. The value is defined by
+  // the hosting environment (i.e. cloud provider).
+  string location = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The display name of the agent, often obtained from the A2A
+  // Agent Card.
+  string display_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The description of the Agent, often obtained from the A2A
+  // Agent Card. Empty if Agent Card has no description.
+  string description = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The version of the Agent, often obtained from the A2A Agent
+  // Card. Empty if Agent Card has no version or agent is not an A2A Agent.
+  string version = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The connection details for the Agent.
+  repeated Protocol protocols = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Skills the agent possesses, often obtained from the A2A Agent
+  // Card.
+  repeated Skill skills = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A universally unique identifier for the Agent.
+  string uid = 10 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OUTPUT_ONLY
+  ];
+
+  // Output only. Create time.
+  google.protobuf.Timestamp create_time = 11
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Update time.
+  google.protobuf.Timestamp update_time = 12
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Attributes of the Agent.
+  // Valid values:
+  //
+  //  * `agentregistry.googleapis.com/system/Framework`: {"framework":
+  //  "google-adk"} - the agent framework used to develop the Agent. Example
+  //  values: "google-adk", "langchain", "custom".
+  //  * `agentregistry.googleapis.com/system/RuntimeIdentity`: {"principal":
+  //  "principal://..."} - the runtime identity associated with the Agent.
+  //  * `agentregistry.googleapis.com/system/RuntimeReference`: {"uri": "//..."}
+  //  - the URI of the underlying resource hosting the Agent, for
+  //  example, the Reasoning Engine URI.
+  map<string, google.protobuf.Struct> attributes = 13
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Full Agent Card payload, when available.
+  Card card = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+}