@techdigger/humanode-agentlink 0.2.0 → 0.3.0

package/dist/esm/index.d.mts

@@ -812,7 +812,7 @@ declare function decodeLinkSession(value: string): AgentLinkSession;
 declare function buildHostedLinkUrl(baseUrl: string, session: AgentLinkSession): string;
 declare function buildEmbeddedHostedLinkUrl(baseUrl: string, session: AgentLinkSession): string;
 
-interface BiomapperLinkProtectedRoute extends Omit<RouteConfig, 'accepts'> {
+interface AgentLinkProtectedRoute extends Omit<RouteConfig, 'accepts'> {
     price: Price | DynamicPrice;
     payTo: string | DynamicPayTo;
     network?: Network;
@@ -820,16 +820,16 @@ interface BiomapperLinkProtectedRoute extends Omit<RouteConfig, 'accepts'> {
     maxTimeoutSeconds?: number;
     extra?: Record<string, unknown>;
 }
-interface BiomapperLinkSchemeRegistration {
+interface AgentLinkSchemeRegistration {
     network: Network;
     server: SchemeNetworkServer;
 }
 /** Generic middleware signature compatible with Hono and similar frameworks. */
 type AgentLinkMiddleware<TContext = unknown> = (context: TContext, next: () => Promise<void>) => Promise<Response | void>;
-interface BiomapperLinkCallable {
+interface AgentLinkCallable {
     <TContext = unknown>(context: TContext, next: () => Promise<void>): Promise<Response | void>;
 }
-interface BiomapperLinkOptions {
+interface AgentLinkOptions {
     /** "base" or "base-sepolia" */
     network: BiomapperRegistryNetwork;
     /** Deployed BiomapperAgentRegistry contract address. */
@@ -857,7 +857,7 @@ interface BiomapperLinkOptions {
     /** Domain for the SIWE message. Derived from request URL if omitted. */
     domain?: string;
     /** Simplified x402 route config for the ready-to-use middleware path. */
-    protect?: Record<string, BiomapperLinkProtectedRoute>;
+    protect?: Record<string, AgentLinkProtectedRoute>;
     /** Full x402 routes config for the ready-to-use middleware path. */
     routes?: RoutesConfig;
     /** Custom facilitator client(s) for the ready-to-use middleware path. */
@@ -865,13 +865,13 @@ interface BiomapperLinkOptions {
     /** Override the default x402 facilitator URL for the ready-to-use middleware path. */
     facilitatorUrl?: string;
     /** Override automatic exact-EVM scheme registration for the ready-to-use middleware path. */
-    schemes?: BiomapperLinkSchemeRegistration[];
+    schemes?: AgentLinkSchemeRegistration[];
     /** Built-in paywall config for the ready-to-use middleware path. */
     paywallConfig?: PaywallConfig;
     /** Custom paywall provider for the ready-to-use middleware path. */
     paywall?: PaywallProvider;
 }
-interface BiomapperLinkControlSurface {
+interface AgentLinkControlSurface {
     extension: typeof agentlinkResourceServerExtension;
     declare(overrides?: Partial<DeclareAgentLinkOptions>): ReturnType<typeof declareAgentLinkExtension>;
     requestHook: ReturnType<typeof createAgentLinkHooks>['requestHook'];
@@ -882,7 +882,7 @@ interface BiomapperLinkControlSurface {
     httpServer?: x402HTTPResourceServer;
 }
 /**
- * One-call setup for Biomapper Link.
+ * One-call setup for Humanode Agentlink.
  *
  * Collapses registry verifier, storage, hooks, extension declaration,
  * and webhook wiring into a single factory. When `protect` or `routes`
@@ -890,7 +890,7 @@ interface BiomapperLinkControlSurface {
  *
  * @example
  * ```ts
- * const link = createBiomapperLink({
+ * const link = createAgentLink({
  *   network: "base-sepolia",
  *   registry: "0xYourRegistry",
  *   protect: {
@@ -904,8 +904,8 @@ interface BiomapperLinkControlSurface {
  * app.use(link);
  * ```
  */
-declare function createBiomapperLink(options: BiomapperLinkOptions): BiomapperLink;
-type BiomapperLink = BiomapperLinkCallable & BiomapperLinkControlSurface;
+declare function createAgentLink(options: AgentLinkOptions): AgentLink;
+type AgentLink = AgentLinkCallable & AgentLinkControlSurface;
 
 /** A Next.js App Router route handler: `(request: Request) => Promise<Response>` */
 type NextRouteHandler = (request: Request) => Promise<Response>;
@@ -960,4 +960,4 @@ declare function verifyAgentLinkWebhookSignature(options: VerifyAgentLinkWebhook
 declare function dispatchAgentLinkWebhook<TEvent extends AgentLinkEvent>(event: TEvent, options: AgentLinkWebhookDispatcherOptions): Promise<AgentLinkWebhookEnvelope<TEvent>>;
 declare function createAgentLinkWebhookDispatcher(options: AgentLinkWebhookDispatcherOptions): AgentLinkEventHandler;
 
-export { AGENTLINK, AGENT_LINK_TYPES, type AgentLinkAuthorization, type AgentLinkConsentClient, type AgentLinkConsentOutput, type AgentLinkConsentSigner, type AgentLinkEntitlement, type AgentLinkEntitlementContext, type AgentLinkEntitlementResolver, type AgentLinkEvent, type AgentLinkEventHandler, type AgentLinkExtension, type AgentLinkExtensionInfo, type AgentLinkExtensionSchema, type AgentLinkHookEvent, type AgentLinkMiddleware, type AgentLinkMode, type AgentLinkPayload, AgentLinkPayloadSchema, type AgentLinkSession, type AgentLinkSessionBranding, type AgentLinkSessionEvent, type AgentLinkSessionStore, type AgentLinkStorage, type AgentLinkUsageContext, type AgentLinkValidationOptions, type AgentLinkValidationResult, type AgentLinkVerifyResult, type AgentLinkWebhookDispatcherOptions, type AgentLinkWebhookEnvelope, type AgentLinkWebhookSignatureVerificationResult, BIOMAPPER_AGENT_REGISTRY_ABI$1 as BIOMAPPER_AGENT_REGISTRY_ABI, BIOMAPPER_AGENT_REGISTRY_NAME, BIOMAPPER_AGENT_REGISTRY_VERSION, BIOMAPPER_APP_URLS, BRIDGED_BIOMAPPER_ADDRESSES, BRIDGED_BIOMAPPER_READ_ABI, type BiomapperAgentStatus, type BiomapperBridgeNetwork, type BiomapperLink, type BiomapperLinkControlSurface, type BiomapperLinkOptions, type BiomapperLinkProtectedRoute, type BiomapperLinkSchemeRegistration, type BiomapperNetworkInfo, BiomapperNetworkSchema, type BiomapperQueryClient, BiomapperQueryError, type BiomapperQueryErrorCode, type BiomapperQueryNetwork, type BiomapperRegistryNetwork, type BiomapperRegistryOptions, type BiomapperRegistryVerifier, CHECK_AGENT_STATUS_TOOL_DESCRIPTION, CHECK_AGENT_STATUS_TOOL_NAME, type CheckAgentStatusInput, CheckAgentStatusInputSchema, type CheckAgentStatusResult, CheckAgentStatusResultSchema, type CompleteAgentLinkInfo, type CreateAgentLinkConsentOptions, type CreateAgentLinkHooksOptions, type CreateBiomapperQueryClientOptions, type CreateLinkSessionInput, type CreateLinkSessionOptions, type DeclareAgentLinkOptions, GET_BIOMAPPER_INFO_TOOL_DESCRIPTION, GET_BIOMAPPER_INFO_TOOL_NAME, GET_CURRENT_GENERATION_TOOL_DESCRIPTION, GET_CURRENT_GENERATION_TOOL_NAME, type GetBiomapperInfoInput, GetBiomapperInfoInputSchema, type GetBiomapperInfoResult, GetBiomapperInfoResultSchema, type GetCurrentGenerationInput, GetCurrentGenerationInputSchema, type GetCurrentGenerationResult, GetCurrentGenerationResultSchema, type HonoLikeMiddleware, type HonoPaymentMiddleware, InMemoryAgentLinkStorage, InMemoryLinkSessionStore, type LinkSessionValidationOptions, type LinkSessionValidationResult, type NextPaymentMiddleware, type NextRouteHandler, type ResolveAgentLinkEntitlementInput, type SignatureScheme, type SignatureType, type SupportedChain, type VerifyAgentLinkWebhookSignatureOptions, agentlinkResourceServerExtension, buildAgentLinkSchema, buildAgentLinkTypedData, buildAgentLinkUsageKey, buildEmbeddedHostedLinkUrl, buildHostedLinkUrl, createAgentLinkConsent, createAgentLinkHooks, createAgentLinkWebhookDispatcher, createAgentLinkWebhookEnvelope, createBiomapperLink, createBiomapperQueryClient, createBiomapperRegistryVerifier, createHonoPaymentMiddlewareFromHTTPServer, createLinkSession, createNextPaymentHandlerFromHTTPServer, declareAgentLinkExtension, decodeLinkSession, dispatchAgentLinkWebhook, encodeLinkSession, extractEVMChainId, formatSIWEMessage, getLinkSession, parseAgentLinkHeader, validateAgentLinkMessage, validateLinkSession, verifyAgentLinkSignature, verifyAgentLinkWebhookSignature, verifyEVMSignature };
+export { AGENTLINK, AGENT_LINK_TYPES, type AgentLink, type AgentLinkAuthorization, type AgentLinkCallable, type AgentLinkConsentClient, type AgentLinkConsentOutput, type AgentLinkConsentSigner, type AgentLinkControlSurface, type AgentLinkEntitlement, type AgentLinkEntitlementContext, type AgentLinkEntitlementResolver, type AgentLinkEvent, type AgentLinkEventHandler, type AgentLinkExtension, type AgentLinkExtensionInfo, type AgentLinkExtensionSchema, type AgentLinkHookEvent, type AgentLinkMiddleware, type AgentLinkMode, type AgentLinkOptions, type AgentLinkPayload, AgentLinkPayloadSchema, type AgentLinkProtectedRoute, type AgentLinkSchemeRegistration, type AgentLinkSession, type AgentLinkSessionBranding, type AgentLinkSessionEvent, type AgentLinkSessionStore, type AgentLinkStorage, type AgentLinkUsageContext, type AgentLinkValidationOptions, type AgentLinkValidationResult, type AgentLinkVerifyResult, type AgentLinkWebhookDispatcherOptions, type AgentLinkWebhookEnvelope, type AgentLinkWebhookSignatureVerificationResult, BIOMAPPER_AGENT_REGISTRY_ABI$1 as BIOMAPPER_AGENT_REGISTRY_ABI, BIOMAPPER_AGENT_REGISTRY_NAME, BIOMAPPER_AGENT_REGISTRY_VERSION, BIOMAPPER_APP_URLS, BRIDGED_BIOMAPPER_ADDRESSES, BRIDGED_BIOMAPPER_READ_ABI, type BiomapperAgentStatus, type BiomapperBridgeNetwork, type BiomapperNetworkInfo, BiomapperNetworkSchema, type BiomapperQueryClient, BiomapperQueryError, type BiomapperQueryErrorCode, type BiomapperQueryNetwork, type BiomapperRegistryNetwork, type BiomapperRegistryOptions, type BiomapperRegistryVerifier, CHECK_AGENT_STATUS_TOOL_DESCRIPTION, CHECK_AGENT_STATUS_TOOL_NAME, type CheckAgentStatusInput, CheckAgentStatusInputSchema, type CheckAgentStatusResult, CheckAgentStatusResultSchema, type CompleteAgentLinkInfo, type CreateAgentLinkConsentOptions, type CreateAgentLinkHooksOptions, type CreateBiomapperQueryClientOptions, type CreateLinkSessionInput, type CreateLinkSessionOptions, type DeclareAgentLinkOptions, GET_BIOMAPPER_INFO_TOOL_DESCRIPTION, GET_BIOMAPPER_INFO_TOOL_NAME, GET_CURRENT_GENERATION_TOOL_DESCRIPTION, GET_CURRENT_GENERATION_TOOL_NAME, type GetBiomapperInfoInput, GetBiomapperInfoInputSchema, type GetBiomapperInfoResult, GetBiomapperInfoResultSchema, type GetCurrentGenerationInput, GetCurrentGenerationInputSchema, type GetCurrentGenerationResult, GetCurrentGenerationResultSchema, type HonoLikeMiddleware, type HonoPaymentMiddleware, InMemoryAgentLinkStorage, InMemoryLinkSessionStore, type LinkSessionValidationOptions, type LinkSessionValidationResult, type NextPaymentMiddleware, type NextRouteHandler, type ResolveAgentLinkEntitlementInput, type SignatureScheme, type SignatureType, type SupportedChain, type VerifyAgentLinkWebhookSignatureOptions, agentlinkResourceServerExtension, buildAgentLinkSchema, buildAgentLinkTypedData, buildAgentLinkUsageKey, buildEmbeddedHostedLinkUrl, buildHostedLinkUrl, createAgentLink, createAgentLinkConsent, createAgentLinkHooks, createAgentLinkWebhookDispatcher, createAgentLinkWebhookEnvelope, createBiomapperQueryClient, createBiomapperRegistryVerifier, createHonoPaymentMiddlewareFromHTTPServer, createLinkSession, createNextPaymentHandlerFromHTTPServer, declareAgentLinkExtension, decodeLinkSession, dispatchAgentLinkWebhook, encodeLinkSession, extractEVMChainId, formatSIWEMessage, getLinkSession, parseAgentLinkHeader, validateAgentLinkMessage, validateLinkSession, verifyAgentLinkSignature, verifyAgentLinkWebhookSignature, verifyEVMSignature };

package/dist/esm/index.mjs

@@ -1565,7 +1565,7 @@ function buildEmbeddedHostedLinkUrl(baseUrl, session) {
   return url.toString();
 }
 
-// src/biomapper-link.ts
+// src/agentlink.ts
 import { registerExactEvmScheme } from "@x402/evm/exact/server";
 import { HTTPFacilitatorClient, x402ResourceServer } from "@x402/core/server";
 import {
@@ -1621,10 +1621,12 @@ function encodeHex(bytes) {
   return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 }
 function constantTimeEqual(left, right) {
-  if (left.length !== right.length) return false;
-  let mismatch = 0;
-  for (let index = 0; index < left.length; index += 1) {
-    mismatch |= left.charCodeAt(index) ^ right.charCodeAt(index);
+  const maxLength = Math.max(left.length, right.length);
+  let mismatch = left.length ^ right.length;
+  for (let index = 0; index < maxLength; index += 1) {
+    const leftCode = index < left.length ? left.charCodeAt(index) : 0;
+    const rightCode = index < right.length ? right.charCodeAt(index) : 0;
+    mismatch |= leftCode ^ rightCode;
   }
   return mismatch === 0;
 }
@@ -1682,8 +1684,8 @@ async function dispatchAgentLinkWebhook(event, options) {
   const body = stringifyWebhookEnvelope(envelope);
   const timestamp = Math.floor(Date.now() / 1e3).toString();
   const signature = options.secret ? await createHmacSignature(options.secret, timestamp, body) : void 0;
+  const includeLegacySecretHeader = options.includeLegacySecretHeader ?? false;
   for (const url of urls) {
-    const includeLegacySecretHeader = options.includeLegacySecretHeader ?? true;
     const response = await fetchImpl(url, {
       method: "POST",
       headers: {
@@ -1825,14 +1827,14 @@ function createHonoPaymentMiddlewareFromHTTPServer(httpServer, paywallConfig, pa
   return { middleware, initialize };
 }
 
-// src/biomapper-link.ts
+// src/agentlink.ts
 var NETWORK_TO_CHAIN_ID = {
   base: "eip155:8453",
   "base-sepolia": "eip155:84532"
 };
 var DEFAULT_X402_FACILITATOR_URL = "https://x402.org/facilitator";
 var hasWarnedAboutInMemoryStorageDefault = false;
-function createBiomapperLink(options) {
+function createAgentLink(options) {
   const chainId = NETWORK_TO_CHAIN_ID[options.network];
   const storage = options.storage ?? resolveDefaultStorage();
   const registry = createBiomapperRegistryVerifier({
@@ -1873,7 +1875,7 @@ function createBiomapperLink(options) {
   let httpServer;
   let middleware = async () => {
     throw new Error(
-      "createBiomapperLink was used as middleware without x402 route configuration. Pass `protect` or `routes` to enable the one-call middleware path."
+      "createAgentLink was used as middleware without x402 route configuration. Pass `protect` or `routes` to enable the one-call middleware path."
     );
   };
   let initialize = async () => {
@@ -1926,20 +1928,20 @@ function createBiomapperLink(options) {
 function resolveDefaultStorage() {
   if (process.env.NODE_ENV === "production") {
     throw new Error(
-      "createBiomapperLink requires an explicit storage backend in production. Pass persistent/shared storage instead of relying on the in-memory development default."
+      "createAgentLink requires an explicit storage backend in production. Pass persistent/shared storage instead of relying on the in-memory development default."
     );
   }
   if (!hasWarnedAboutInMemoryStorageDefault) {
     hasWarnedAboutInMemoryStorageDefault = true;
     console.warn(
-      "[agentlink] createBiomapperLink is using InMemoryAgentLinkStorage because no storage backend was provided. This is only safe for local development and tests."
+      "[agentlink] createAgentLink is using InMemoryAgentLinkStorage because no storage backend was provided. This is only safe for local development and tests."
     );
   }
   return new InMemoryAgentLinkStorage();
 }
 function buildRoutes(options, agentlinkExtensions, defaultNetwork) {
   if (options.routes && options.protect) {
-    throw new Error("Pass either `routes` or `protect` to createBiomapperLink, not both.");
+    throw new Error("Pass either `routes` or `protect` to createAgentLink, not both.");
   }
   if (options.routes) {
     return mergeAgentLinkExtensions(options.routes, agentlinkExtensions);
@@ -2185,11 +2187,11 @@ export {
   buildAgentLinkUsageKey,
   buildEmbeddedHostedLinkUrl,
   buildHostedLinkUrl,
+  createAgentLink,
   createAgentLinkConsent,
   createAgentLinkHooks,
   createAgentLinkWebhookDispatcher,
   createAgentLinkWebhookEnvelope,
-  createBiomapperLink,
   createBiomapperQueryClient,
   createBiomapperRegistryVerifier,
   createHonoPaymentMiddlewareFromHTTPServer,