@superblocksteam/sdk-api 2.0.96 → 2.0.97-next.1

package/src/integrations/dynamodb/types.ts

@@ -7,6 +7,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * DynamoDB AttributeValue type descriptor.
@@ -100,6 +101,7 @@ export interface DynamoDBClient extends BaseIntegrationClient {
     statement: string,
     schema: z.ZodSchema<T>,
     params?: DynamoDBAttributeValue[],
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -108,12 +110,14 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    * @param table - The table name
    * @param key - The primary key as AttributeValue map
    * @param schema - Zod schema for validating the result
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated result
    */
   getItem<T>(
     table: string,
     key: Record<string, DynamoDBAttributeValue>,
     schema: z.ZodSchema<T>,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -123,7 +127,9 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    * @param schema - Zod schema for validating the result
    * @param filterExpression - Optional filter expression (e.g., 'status = :s')
    * @param expressionAttributeValues - Values for expression placeholders
-   * @param expressionAttributeNames - Name aliases for reserved words
+   * @param expressionAttributeNames - Name aliases for reserved words. **Note:** since both
+   *   this param and `metadata` accept plain objects, pass `undefined` when you only need metadata.
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated result
    */
   scan<T>(
@@ -132,6 +138,7 @@ export interface DynamoDBClient extends BaseIntegrationClient {
     filterExpression?: string,
     expressionAttributeValues?: Record<string, DynamoDBAttributeValue>,
     expressionAttributeNames?: Record<string, string>,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -141,7 +148,9 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    * @param keyConditionExpression - Key condition (e.g., 'pk = :pk')
    * @param expressionAttributeValues - Values for expression placeholders
    * @param schema - Zod schema for validating the result
-   * @param expressionAttributeNames - Optional name aliases for reserved words
+   * @param expressionAttributeNames - Optional name aliases for reserved words. **Note:** since both
+   *   this param and `metadata` accept plain objects, pass `undefined` when you only need metadata.
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated result
    */
   queryTable<T>(
@@ -150,6 +159,7 @@ export interface DynamoDBClient extends BaseIntegrationClient {
     expressionAttributeValues: Record<string, DynamoDBAttributeValue>,
     schema: z.ZodSchema<T>,
     expressionAttributeNames?: Record<string, string>,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -157,11 +167,13 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    *
    * @param table - The table name
    * @param item - The item as an AttributeValue map
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from DynamoDB
    */
   putItem(
     table: string,
     item: Record<string, DynamoDBAttributeValue>,
+    metadata?: TraceMetadata,
   ): Promise<unknown>;
 
   /**
@@ -171,7 +183,9 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    * @param key - The primary key as AttributeValue map
    * @param updateExpression - Update expression (e.g., 'SET #n = :name, age = :age')
    * @param expressionAttributeValues - Values for expression placeholders
-   * @param expressionAttributeNames - Optional name aliases for reserved words
+   * @param expressionAttributeNames - Optional name aliases for reserved words. **Note:** since both
+   *   this param and `metadata` accept plain objects, pass `undefined` when you only need metadata.
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from DynamoDB
    */
   updateItem(
@@ -180,6 +194,7 @@ export interface DynamoDBClient extends BaseIntegrationClient {
     updateExpression: string,
     expressionAttributeValues: Record<string, DynamoDBAttributeValue>,
     expressionAttributeNames?: Record<string, string>,
+    metadata?: TraceMetadata,
   ): Promise<unknown>;
 
   /**
@@ -187,45 +202,56 @@ export interface DynamoDBClient extends BaseIntegrationClient {
    *
    * @param table - The table name
    * @param key - The primary key as AttributeValue map
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from DynamoDB
    */
   deleteItem(
     table: string,
     key: Record<string, DynamoDBAttributeValue>,
+    metadata?: TraceMetadata,
   ): Promise<unknown>;
 
   /**
    * Write multiple items in a single batch.
    *
    * @param requestItems - Map of table names to write request arrays
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from DynamoDB
    */
   batchWriteItem(
     requestItems: Record<string, Array<Record<string, unknown>>>,
+    metadata?: TraceMetadata,
   ): Promise<unknown>;
 
   /**
    * List all DynamoDB tables.
    *
    * @param schema - Zod schema for validating the result
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated table list
    */
-  listTables<T>(schema: z.ZodSchema<T>): Promise<T>;
+  listTables<T>(schema: z.ZodSchema<T>, metadata?: TraceMetadata): Promise<T>;
 
   /**
    * Describe a DynamoDB table's structure and metadata.
    *
    * @param table - The table name
    * @param schema - Zod schema for validating the result
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated table description
    */
-  describeTable<T>(table: string, schema: z.ZodSchema<T>): Promise<T>;
+  describeTable<T>(
+    table: string,
+    schema: z.ZodSchema<T>,
+    metadata?: TraceMetadata,
+  ): Promise<T>;
 
   /**
    * Delete a DynamoDB table.
    *
    * @param table - The table name to delete
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from DynamoDB
    */
-  deleteTable(table: string): Promise<unknown>;
+  deleteTable(table: string, metadata?: TraceMetadata): Promise<unknown>;
 }

package/src/integrations/elasticsearch/README.md

@@ -4,9 +4,9 @@ Search, index, and manage documents in Elasticsearch clusters.
 
 ## Methods
 
-| Method                        | Description                                               |
-| ----------------------------- | --------------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Elasticsearch API request with schema validation |
+| Method                                   | Description                                               |
+| ---------------------------------------- | --------------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Elasticsearch API request with schema validation |
 
 ## Usage
 
@@ -379,6 +379,10 @@ try {
 }
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/fireworks/README.md

@@ -4,9 +4,9 @@ Interact with Fireworks AI's fast inference platform for LLM chat completions an
 
 ## Methods
 
-| Method                        | Description                                           |
-| ----------------------------- | ----------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Fireworks API request with schema validation |
+| Method                                   | Description                                           |
+| ---------------------------------------- | ----------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Fireworks API request with schema validation |
 
 ## Usage
 
@@ -261,6 +261,10 @@ const result = await ctx.integrations.fireworks.apiRequest(
 );
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/front/README.md

@@ -4,9 +4,9 @@ Manage conversations, contacts, and team inboxes with Front's collaborative emai
 
 ## Methods
 
-| Method                        | Description                                       |
-| ----------------------------- | ------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Front API request with schema validation |
+| Method                                   | Description                                       |
+| ---------------------------------------- | ------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Front API request with schema validation |
 
 ## Usage
 
@@ -271,6 +271,10 @@ const result = await ctx.integrations.front.apiRequest(
 );
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/gcs/README.md

@@ -4,15 +4,15 @@ Interact with Google Cloud Storage buckets with full type safety and runtime val
 
 ## Methods
 
-| Method                                       | Description              |
-| -------------------------------------------- | ------------------------ |
-| `listBuckets(schema)`                        | List all buckets         |
-| `listObjects(bucket, schema, options?)`      | List objects in a bucket |
-| `getObject(bucket, path, schema, options?)`  | Get an object            |
-| `deleteObject(bucket, path)`                 | Delete an object         |
-| `uploadObject(bucket, path, body)`           | Upload a single object   |
-| `uploadMultipleObjects(bucket, fileObjects)` | Upload multiple objects  |
-| `generateSignedUrl(bucket, path, schema)`    | Generate a signed URL    |
+| Method                                                  | Description              |
+| ------------------------------------------------------- | ------------------------ |
+| `listBuckets(schema, metadata?)`                        | List all buckets         |
+| `listObjects(bucket, schema, options?, metadata?)`      | List objects in a bucket |
+| `getObject(bucket, path, schema, options?, metadata?)`  | Get an object            |
+| `deleteObject(bucket, path, metadata?)`                 | Delete an object         |
+| `uploadObject(bucket, path, body, metadata?)`           | Upload a single object   |
+| `uploadMultipleObjects(bucket, fileObjects, metadata?)` | Upload multiple objects  |
+| `generateSignedUrl(bucket, path, schema, metadata?)`    | Generate a signed URL    |
 
 ## Usage
 
@@ -104,6 +104,10 @@ const url = await ctx.integrations.storage.generateSignedUrl(
 );
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### Size is Returned as String

package/src/integrations/gcs/client.ts

@@ -8,7 +8,7 @@ import type { z } from "zod";
 import type { PartialMessage } from "@bufbuild/protobuf";
 import type { Plugin as GCSPlugin } from "@superblocksteam/types/dist/src/plugins/gcs/v1/plugin_pb";
 import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
-import type { QueryExecutor } from "../registry.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
 import { RestApiValidationError } from "../../errors.js";
 import { IntegrationError } from "../../runtime/errors.js";
 import type {
@@ -44,13 +44,18 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
   private async execute(
     action: GCSAction,
     request: PartialMessage<GCSPlugin>,
+    metadata?: TraceMetadata,
   ): Promise<unknown> {
     const fullRequest: PartialMessage<GCSPlugin> = {
       ...request,
       action,
     };
 
-    return this.executeQuery(fullRequest as Record<string, unknown>);
+    return this.executeQuery(
+      fullRequest as Record<string, unknown>,
+      undefined,
+      metadata,
+    );
   }
 
   /**
@@ -97,9 +102,12 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     }
   }
 
-  async listBuckets<T>(schema: z.ZodSchema<T>): Promise<T> {
+  async listBuckets<T>(
+    schema: z.ZodSchema<T>,
+    metadata?: TraceMetadata,
+  ): Promise<T> {
     return this.withErrorHandling("listBuckets", async () => {
-      const result = await this.execute("LIST_BUCKETS", {});
+      const result = await this.execute("LIST_BUCKETS", {}, metadata);
       return this.validate(result, schema, "listBuckets");
     });
   }
@@ -108,6 +116,7 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     bucket: string,
     schema: z.ZodSchema<T>,
     options?: GCSListObjectsOptions,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     return this.withErrorHandling("listObjects", async () => {
       const request: PartialMessage<GCSPlugin> = {
@@ -118,7 +127,11 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
         request.prefix = options.prefix;
       }
 
-      const result = await this.execute("LIST_BUCKET_OBJECTS", request);
+      const result = await this.execute(
+        "LIST_BUCKET_OBJECTS",
+        request,
+        metadata,
+      );
       return this.validate(result, schema, "listObjects");
     });
   }
@@ -128,6 +141,7 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     path: string,
     schema: z.ZodSchema<T>,
     options?: GCSGetObjectOptions,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     return this.withErrorHandling("getObject", async () => {
       const request: PartialMessage<GCSPlugin> = {
@@ -139,17 +153,25 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
         request.responseType = options.responseType;
       }
 
-      const result = await this.execute("GET_OBJECT", request);
+      const result = await this.execute("GET_OBJECT", request, metadata);
       return this.validate(result, schema, "getObject");
     });
   }
 
-  async deleteObject(bucket: string, path: string): Promise<void> {
+  async deleteObject(
+    bucket: string,
+    path: string,
+    metadata?: TraceMetadata,
+  ): Promise<void> {
     return this.withErrorHandling("deleteObject", async () => {
-      await this.execute("DELETE_OBJECT", {
-        resource: bucket,
-        path,
-      });
+      await this.execute(
+        "DELETE_OBJECT",
+        {
+          resource: bucket,
+          path,
+        },
+        metadata,
+      );
     });
   }
 
@@ -157,25 +179,35 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     bucket: string,
     path: string,
     body: string,
+    metadata?: TraceMetadata,
   ): Promise<void> {
     return this.withErrorHandling("uploadObject", async () => {
-      await this.execute("UPLOAD_OBJECT", {
-        resource: bucket,
-        path,
-        body,
-      });
+      await this.execute(
+        "UPLOAD_OBJECT",
+        {
+          resource: bucket,
+          path,
+          body,
+        },
+        metadata,
+      );
     });
   }
 
   async uploadMultipleObjects(
     bucket: string,
     fileObjects: string,
+    metadata?: TraceMetadata,
   ): Promise<void> {
     return this.withErrorHandling("uploadMultipleObjects", async () => {
-      await this.execute("UPLOAD_MULTIPLE_OBJECTS", {
-        resource: bucket,
-        fileObjects,
-      });
+      await this.execute(
+        "UPLOAD_MULTIPLE_OBJECTS",
+        {
+          resource: bucket,
+          fileObjects,
+        },
+        metadata,
+      );
     });
   }
 
@@ -183,12 +215,17 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     bucket: string,
     path: string,
     schema: z.ZodSchema<T>,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     return this.withErrorHandling("generateSignedUrl", async () => {
-      const result = await this.execute("GENERATE_PRESIGNED_URL", {
-        resource: bucket,
-        path,
-      });
+      const result = await this.execute(
+        "GENERATE_PRESIGNED_URL",
+        {
+          resource: bucket,
+          path,
+        },
+        metadata,
+      );
       return this.validate(result, schema, "generateSignedUrl");
     });
   }

package/src/integrations/gcs/types.ts

@@ -4,6 +4,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * GCS action types (used internally by the client).
@@ -72,7 +73,7 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param schema - Zod schema for validating the result
    * @returns The validated bucket list
    */
-  listBuckets<T>(schema: z.ZodSchema<T>): Promise<T>;
+  listBuckets<T>(schema: z.ZodSchema<T>, metadata?: TraceMetadata): Promise<T>;
 
   /**
    * List objects in a bucket.
@@ -80,12 +81,14 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param bucket - Bucket name
    * @param schema - Zod schema for validating the result
    * @param options - Optional prefix filter
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated object list
    */
   listObjects<T>(
     bucket: string,
     schema: z.ZodSchema<T>,
     options?: GCSListObjectsOptions,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -95,6 +98,7 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param path - Object path
    * @param schema - Zod schema for validating the result
    * @param options - Optional response type
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated object content
    */
   getObject<T>(
@@ -102,6 +106,7 @@ export interface GCSClient extends BaseIntegrationClient {
     path: string,
     schema: z.ZodSchema<T>,
     options?: GCSGetObjectOptions,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 
   /**
@@ -109,8 +114,13 @@ export interface GCSClient extends BaseIntegrationClient {
    *
    * @param bucket - Bucket name
    * @param path - Object path
+   * @param metadata - Optional trace metadata for diagnostics
    */
-  deleteObject(bucket: string, path: string): Promise<void>;
+  deleteObject(
+    bucket: string,
+    path: string,
+    metadata?: TraceMetadata,
+  ): Promise<void>;
 
   /**
    * Upload an object to a bucket.
@@ -118,16 +128,27 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param bucket - Bucket name
    * @param path - Object path
    * @param body - File content (base64 or text)
+   * @param metadata - Optional trace metadata for diagnostics
    */
-  uploadObject(bucket: string, path: string, body: string): Promise<void>;
+  uploadObject(
+    bucket: string,
+    path: string,
+    body: string,
+    metadata?: TraceMetadata,
+  ): Promise<void>;
 
   /**
    * Upload multiple objects to a bucket.
    *
    * @param bucket - Bucket name
    * @param fileObjects - Serialized file objects
+   * @param metadata - Optional trace metadata for diagnostics
    */
-  uploadMultipleObjects(bucket: string, fileObjects: string): Promise<void>;
+  uploadMultipleObjects(
+    bucket: string,
+    fileObjects: string,
+    metadata?: TraceMetadata,
+  ): Promise<void>;
 
   /**
    * Generate a signed URL for an object.
@@ -135,11 +156,13 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param bucket - Bucket name
    * @param path - Object path
    * @param schema - Zod schema for validating the result
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated signed URL
    */
   generateSignedUrl<T>(
     bucket: string,
     path: string,
     schema: z.ZodSchema<T>,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 }

package/src/integrations/gemini/README.md

@@ -4,9 +4,9 @@ Interact with Google's Gemini API for multimodal AI capabilities including text,
 
 ## Methods
 
-| Method                        | Description                                        |
-| ----------------------------- | -------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Gemini API request with schema validation |
+| Method                                   | Description                                        |
+| ---------------------------------------- | -------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Gemini API request with schema validation |
 
 ## Usage
 
@@ -259,6 +259,10 @@ const result = await ctx.integrations.gemini.apiRequest(
 console.log(`Total tokens: ${result.totalTokens}`);
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/github/README.md

@@ -4,9 +4,9 @@ Manage repositories, issues, pull requests, and interact with GitHub's APIs.
 
 ## Methods
 
-| Method                        | Description                                        |
-| ----------------------------- | -------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any GitHub API request with schema validation |
+| Method                                   | Description                                        |
+| ---------------------------------------- | -------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any GitHub API request with schema validation |
 
 ## Usage
 
@@ -283,6 +283,10 @@ await ctx.integrations.repo.apiRequest(
 );
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/googleanalytics/README.md

@@ -4,9 +4,9 @@ Run reports, get real-time data, and interact with Google Analytics 4 properties
 
 ## Methods
 
-| Method                        | Description                                                  |
-| ----------------------------- | ------------------------------------------------------------ |
-| `apiRequest(options, schema)` | Make any Google Analytics API request with schema validation |
+| Method                                   | Description                                                  |
+| ---------------------------------------- | ------------------------------------------------------------ |
+| `apiRequest(options, schema, metadata?)` | Make any Google Analytics API request with schema validation |
 
 ## Usage
 
@@ -238,6 +238,10 @@ result.accountSummaries?.forEach((account) => {
 });
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/googledrive/README.md

@@ -4,9 +4,9 @@ Upload, download, and manage files in Google Drive.
 
 ## Methods
 
-| Method                        | Description                                              |
-| ----------------------------- | -------------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Google Drive API request with schema validation |
+| Method                                   | Description                                              |
+| ---------------------------------------- | -------------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Google Drive API request with schema validation |
 
 ## Usage
 
@@ -289,6 +289,10 @@ await ctx.integrations.drive.apiRequest(
 );
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### No Specialized Methods

package/src/integrations/graphql/README.md

@@ -4,10 +4,10 @@ Execute GraphQL queries and mutations against configured GraphQL endpoints with
 
 ## Methods
 
-| Method                                      | Description                                                |
-| ------------------------------------------- | ---------------------------------------------------------- |
-| `query<T>(query, schema, variables?)`       | Execute a GraphQL query with required schema validation    |
-| `mutation<T>(mutation, schema, variables?)` | Execute a GraphQL mutation with required schema validation |
+| Method                                                 | Description                                                |
+| ------------------------------------------------------ | ---------------------------------------------------------- |
+| `query<T>(query, schema, variables?, metadata?)`       | Execute a GraphQL query with required schema validation    |
+| `mutation<T>(mutation, schema, variables?, metadata?)` | Execute a GraphQL mutation with required schema validation |
 
 ## Usage
 
@@ -196,6 +196,10 @@ const UserProfileResponseSchema = z.object({
 });
 ```
 
+## Trace Metadata
+
+All methods accept an optional `metadata` parameter as the last argument for diagnostics labeling. See the [root SDK README](../../../README.md#trace-metadata) for details.
+
 ## Common Pitfalls
 
 ### Response Must Include `data` Wrapper