@nevermined-io/commons 1.2.2 → 1.3.0

package/dist/lib/types/DDOTypes.d.ts

@@ -54,6 +54,16 @@ export interface AgentMetadata {
      * This attribute is useful to indicate which endpoints are available for public access (documentation, definitions, etc).
      */
     openEndpoints?: string[];
+    /**
+     * URL to a discoverable agent definition (A2A Agent Card, MCP Manifest, or
+     * OpenAPI spec). Used for documentation/discovery only.
+     */
+    agentDefinitionUrl?: string;
+    /**
+     * The integration protocol the agent speaks. Drives the registration UX
+     * guidance and discovery/catalogue categorisation. Optional.
+     */
+    integrationType?: AgentIntegrationType;
     requiredHeaders?: {
         [verb: string]: string;
     }[];
@@ -135,6 +145,17 @@ export declare enum ApiAuthenticationType {
     bearer = "bearer",
     oauth = "oauth"
 }
+/**
+ * The integration protocol an agent exposes. Mirrors the taxonomy Google's
+ * Agentic Resource Discovery catalogue switches on (A2A / MCP / OpenAPI), plus
+ * an "other" escape hatch.
+ */
+export declare enum AgentIntegrationType {
+    a2a = "a2a",
+    mcp = "mcp",
+    rest = "rest",
+    other = "other"
+}
 export type ApiEndpoint = {
     [verb: string]: string;
 };

package/dist/lib/types/DDOTypes.d.ts.map

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

package/dist/lib/types/DDOTypes.js

@@ -5,6 +5,17 @@ export var ApiAuthenticationType = /*#__PURE__*/ function(ApiAuthenticationType)
     ApiAuthenticationType["oauth"] = "oauth";
     return ApiAuthenticationType;
 }({});
+/**
+ * The integration protocol an agent exposes. Mirrors the taxonomy Google's
+ * Agentic Resource Discovery catalogue switches on (A2A / MCP / OpenAPI), plus
+ * an "other" escape hatch.
+ */ export var AgentIntegrationType = /*#__PURE__*/ function(AgentIntegrationType) {
+    AgentIntegrationType["a2a"] = "a2a";
+    AgentIntegrationType["mcp"] = "mcp";
+    AgentIntegrationType["rest"] = "rest";
+    AgentIntegrationType["other"] = "other";
+    return AgentIntegrationType;
+}({});
 export var AgentTaskStatus = /*#__PURE__*/ function(AgentTaskStatus) {
     AgentTaskStatus["SUCCESS"] = "Success";
     AgentTaskStatus["FAILURE"] = "Failure";

package/dist/lib/types/DDOTypes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/types/DDOTypes.ts"],"sourcesContent":["import { CreditsConfig, PriceConfig } from './ContractsTypes.js'\n\nexport interface Metadata {\n  serviceEndpoint: string\n  main: MetadataMainAttributes\n  agent?: AgentMetadata\n  additionalInformation?: unknown\n  curation: Curation\n  plan?: PlanMetadata\n}\n\nexport interface NvmConfigVersions {\n  id: number\n  updated: string\n  checksum: string\n}\nexport interface NvmConfig {\n  userId: string\n  userAddress: string\n  appId: string\n  versions: NvmConfigVersions[]\n}\n\nexport interface Proof {\n  created: string\n  creator: string\n  signatureValue: string\n  type: string\n}\n\nexport interface MetadataMainAttributes {\n  name: string\n  description?: string\n  author?: string\n  dateCreated?: string\n  datePublished?: string\n  license?: string\n  tags?: string[]\n}\n\n/**\n * Interface describing an asset of type `service`\n */\nexport interface AgentMetadata {\n  /**\n   * Type of Web service\n   */\n  apiType?: 'restful' | 'graphql' | 'rpc' | 'other'\n\n  /**\n   * Authentication required by the API\n   */\n  authentication?: ResourceAuthentication\n\n  /**\n   * List of endpoints of the API exposed by the Agent\n   */\n  endpoints?: ApiEndpoint[]\n\n  /**\n   * List of open endpoints available for the agent. These endpoints are not protected.\n   * This attribute is useful to indicate which endpoints are available for public access (documentation, definitions, etc).\n   */\n  openEndpoints?: string[]\n\n  requiredHeaders?: { [verb: string]: string }[]\n\n  encryptedAttributes?: string\n}\n\nexport interface PlanMetadata {\n  isTrialPlan?: boolean\n  productId?: string\n  priceId?: string\n  recurringSubscription?: boolean\n  accessLimit: 'credits' | 'time'\n  fiatPaymentProvider?: 'stripe' | 'braintree'\n  currency?: string\n  /**\n   * x402 payment scheme identifier (e.g., 'nvm:erc4337')\n   */\n  x402Scheme?: string\n  /**\n   * URL of the x402 facilitator endpoint\n   */\n  x402FacilitatorUrl?: string\n  /**\n   * URL to the x402 scheme specification\n   */\n  x402SpecUrl?: string\n}\n\nexport interface AgentRegistry {\n  owner: string\n  creator: string\n  url: string\n  lastUpdated: string\n  plans: string[]\n}\n\nexport interface PlanRegistry {\n  owner: string\n  lastUpdated: string\n  price: PriceConfig\n  credits: CreditsConfig\n}\n\nexport interface ResourceAuthentication {\n  type: ApiAuthenticationType\n\n  user?: string\n  password?: string\n  token?: string\n  encrypted?: boolean\n  privateParameters?: { [name: string]: string }[]\n}\n\n/**\n * Curation attributes of Assets Metadata.\n * @see https://github.com/nevermined-io/docs/blob/master/docs/architecture/specs/metadata/README.md#curation-attributes\n */\nexport interface Curation {\n  /**\n   * Decimal value between 0 and 1. 0 is the default value.\n   * @example 0.93\n   */\n  rating: number\n\n  /**\n   * Number of votes. 0 is the default value.\n   * @example 123\n   */\n  numVotes: number\n\n  /**\n   * Schema applied to calculate the rating.\n   * @example \"Binary Voting\"\n   */\n  schema?: string\n\n  /**\n   * Flag unsuitable content.\n   * @example true\n   */\n  isListed?: boolean\n}\n\nexport enum ApiAuthenticationType {\n  none = 'none',\n  basic = 'basic',\n  bearer = 'bearer',\n  oauth = 'oauth',\n}\n\nexport type ApiEndpoint = { [verb: string]: string }\n\nexport enum AgentTaskStatus {\n  SUCCESS = 'Success',\n  FAILURE = 'Failure',\n  PENDING = 'Pending',\n  IN_PROGRESS = 'In_Progress',\n}\n"],"names":["ApiAuthenticationType","AgentTaskStatus"],"mappings":"AAmJA,OAAO,IAAA,AAAKA,+CAAAA;;;;;WAAAA;MAKX;AAID,OAAO,IAAA,AAAKC,yCAAAA;;;;;WAAAA;MAKX"}
+{"version":3,"sources":["../../../src/lib/types/DDOTypes.ts"],"sourcesContent":["import { CreditsConfig, PriceConfig } from './ContractsTypes.js'\n\nexport interface Metadata {\n  serviceEndpoint: string\n  main: MetadataMainAttributes\n  agent?: AgentMetadata\n  additionalInformation?: unknown\n  curation: Curation\n  plan?: PlanMetadata\n}\n\nexport interface NvmConfigVersions {\n  id: number\n  updated: string\n  checksum: string\n}\nexport interface NvmConfig {\n  userId: string\n  userAddress: string\n  appId: string\n  versions: NvmConfigVersions[]\n}\n\nexport interface Proof {\n  created: string\n  creator: string\n  signatureValue: string\n  type: string\n}\n\nexport interface MetadataMainAttributes {\n  name: string\n  description?: string\n  author?: string\n  dateCreated?: string\n  datePublished?: string\n  license?: string\n  tags?: string[]\n}\n\n/**\n * Interface describing an asset of type `service`\n */\nexport interface AgentMetadata {\n  /**\n   * Type of Web service\n   */\n  apiType?: 'restful' | 'graphql' | 'rpc' | 'other'\n\n  /**\n   * Authentication required by the API\n   */\n  authentication?: ResourceAuthentication\n\n  /**\n   * List of endpoints of the API exposed by the Agent\n   */\n  endpoints?: ApiEndpoint[]\n\n  /**\n   * List of open endpoints available for the agent. These endpoints are not protected.\n   * This attribute is useful to indicate which endpoints are available for public access (documentation, definitions, etc).\n   */\n  openEndpoints?: string[]\n\n  /**\n   * URL to a discoverable agent definition (A2A Agent Card, MCP Manifest, or\n   * OpenAPI spec). Used for documentation/discovery only.\n   */\n  agentDefinitionUrl?: string\n\n  /**\n   * The integration protocol the agent speaks. Drives the registration UX\n   * guidance and discovery/catalogue categorisation. Optional.\n   */\n  integrationType?: AgentIntegrationType\n\n  requiredHeaders?: { [verb: string]: string }[]\n\n  encryptedAttributes?: string\n}\n\nexport interface PlanMetadata {\n  isTrialPlan?: boolean\n  productId?: string\n  priceId?: string\n  recurringSubscription?: boolean\n  accessLimit: 'credits' | 'time'\n  fiatPaymentProvider?: 'stripe' | 'braintree'\n  currency?: string\n  /**\n   * x402 payment scheme identifier (e.g., 'nvm:erc4337')\n   */\n  x402Scheme?: string\n  /**\n   * URL of the x402 facilitator endpoint\n   */\n  x402FacilitatorUrl?: string\n  /**\n   * URL to the x402 scheme specification\n   */\n  x402SpecUrl?: string\n}\n\nexport interface AgentRegistry {\n  owner: string\n  creator: string\n  url: string\n  lastUpdated: string\n  plans: string[]\n}\n\nexport interface PlanRegistry {\n  owner: string\n  lastUpdated: string\n  price: PriceConfig\n  credits: CreditsConfig\n}\n\nexport interface ResourceAuthentication {\n  type: ApiAuthenticationType\n\n  user?: string\n  password?: string\n  token?: string\n  encrypted?: boolean\n  privateParameters?: { [name: string]: string }[]\n}\n\n/**\n * Curation attributes of Assets Metadata.\n * @see https://github.com/nevermined-io/docs/blob/master/docs/architecture/specs/metadata/README.md#curation-attributes\n */\nexport interface Curation {\n  /**\n   * Decimal value between 0 and 1. 0 is the default value.\n   * @example 0.93\n   */\n  rating: number\n\n  /**\n   * Number of votes. 0 is the default value.\n   * @example 123\n   */\n  numVotes: number\n\n  /**\n   * Schema applied to calculate the rating.\n   * @example \"Binary Voting\"\n   */\n  schema?: string\n\n  /**\n   * Flag unsuitable content.\n   * @example true\n   */\n  isListed?: boolean\n}\n\nexport enum ApiAuthenticationType {\n  none = 'none',\n  basic = 'basic',\n  bearer = 'bearer',\n  oauth = 'oauth',\n}\n\n/**\n * The integration protocol an agent exposes. Mirrors the taxonomy Google's\n * Agentic Resource Discovery catalogue switches on (A2A / MCP / OpenAPI), plus\n * an \"other\" escape hatch.\n */\nexport enum AgentIntegrationType {\n  a2a = 'a2a',\n  mcp = 'mcp',\n  rest = 'rest',\n  other = 'other',\n}\n\nexport type ApiEndpoint = { [verb: string]: string }\n\nexport enum AgentTaskStatus {\n  SUCCESS = 'Success',\n  FAILURE = 'Failure',\n  PENDING = 'Pending',\n  IN_PROGRESS = 'In_Progress',\n}\n"],"names":["ApiAuthenticationType","AgentIntegrationType","AgentTaskStatus"],"mappings":"AA+JA,OAAO,IAAA,AAAKA,+CAAAA;;;;;WAAAA;MAKX;AAED;;;;CAIC,GACD,OAAO,IAAA,AAAKC,8CAAAA;;;;;WAAAA;MAKX;AAID,OAAO,IAAA,AAAKC,yCAAAA;;;;;WAAAA;MAKX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevermined-io/commons",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "type": "module",
   "main": "../dist/index.js",
   "module": "./dist/index.js",

package/src/lib/types/DDOTypes.ts

@@ -63,6 +63,18 @@ export interface AgentMetadata {
    */
   openEndpoints?: string[]
 
+  /**
+   * URL to a discoverable agent definition (A2A Agent Card, MCP Manifest, or
+   * OpenAPI spec). Used for documentation/discovery only.
+   */
+  agentDefinitionUrl?: string
+
+  /**
+   * The integration protocol the agent speaks. Drives the registration UX
+   * guidance and discovery/catalogue categorisation. Optional.
+   */
+  integrationType?: AgentIntegrationType
+
   requiredHeaders?: { [verb: string]: string }[]
 
   encryptedAttributes?: string
@@ -152,6 +164,18 @@ export enum ApiAuthenticationType {
   oauth = 'oauth',
 }
 
+/**
+ * The integration protocol an agent exposes. Mirrors the taxonomy Google's
+ * Agentic Resource Discovery catalogue switches on (A2A / MCP / OpenAPI), plus
+ * an "other" escape hatch.
+ */
+export enum AgentIntegrationType {
+  a2a = 'a2a',
+  mcp = 'mcp',
+  rest = 'rest',
+  other = 'other',
+}
+
 export type ApiEndpoint = { [verb: string]: string }
 
 export enum AgentTaskStatus {