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

package/src/integrations/graphql/types.ts

@@ -3,6 +3,7 @@
  */
 
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 import type { z } from "zod";
 
 /**
@@ -68,7 +69,10 @@ export interface GraphQLClient extends BaseIntegrationClient {
    *
    * @param query - GraphQL query string
    * @param schema - Zod schema for response validation (REQUIRED)
-   * @param variables - Optional variables for the query
+   * @param variables - Optional variables for the query. **Note:** since both `variables` and
+   *   `metadata` accept plain objects, pass `undefined` for variables when you only need metadata:
+   *   `query(q, schema, undefined, { label: "..." })`
+   * @param metadata - Optional trace metadata for observability
    * @returns Validated query result
    *
    * @example
@@ -89,6 +93,7 @@ export interface GraphQLClient extends BaseIntegrationClient {
     query: string,
     schema: { response: z.ZodSchema<TResponse> },
     variables?: Record<string, unknown>,
+    metadata?: TraceMetadata,
   ): Promise<TResponse>;
 
   /**
@@ -96,7 +101,10 @@ export interface GraphQLClient extends BaseIntegrationClient {
    *
    * @param mutation - GraphQL mutation string
    * @param schema - Zod schema for response validation (REQUIRED)
-   * @param variables - Optional variables for the mutation
+   * @param variables - Optional variables for the mutation. **Note:** since both `variables` and
+   *   `metadata` accept plain objects, pass `undefined` for variables when you only need metadata:
+   *   `mutation(m, schema, undefined, { label: "..." })`
+   * @param metadata - Optional trace metadata for observability
    * @returns Validated mutation result
    *
    * @example
@@ -118,5 +126,6 @@ export interface GraphQLClient extends BaseIntegrationClient {
     mutation: string,
     schema: { response: z.ZodSchema<TResponse> },
     variables?: Record<string, unknown>,
+    metadata?: TraceMetadata,
   ): Promise<TResponse>;
 }

package/src/integrations/groq/README.md

@@ -4,9 +4,9 @@ Interact with Groq's ultra-fast inference API for LLM chat completions with low
 
 ## Methods
 
-| Method                        | Description                                      |
-| ----------------------------- | ------------------------------------------------ |
-| `apiRequest(options, schema)` | Make any Groq API request with schema validation |
+| Method                                   | Description                                      |
+| ---------------------------------------- | ------------------------------------------------ |
+| `apiRequest(options, schema, metadata?)` | Make any Groq API request with schema validation |
 
 ## Usage
 
@@ -219,6 +219,10 @@ const result = await ctx.integrations.groq.apiRequest(
 const data = JSON.parse(result.choices[0]?.message.content ?? "{}");
 ```
 
+## 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/gsheets/README.md

@@ -4,9 +4,9 @@ Interact with Google Sheets with full type safety and runtime validation.
 
 ## Methods
 
-| Method                        | Description                       |
-| ----------------------------- | --------------------------------- |
-| `run(action, schema, params)` | Execute a Google Sheets operation |
+| Method                                   | Description                       |
+| ---------------------------------------- | --------------------------------- |
+| `run(action, schema, params, metadata?)` | Execute a Google Sheets operation |
 
 ## Actions
 
@@ -129,6 +129,10 @@ await ctx.integrations.sheets.run("CREATE_WORKSHEET", z.any(), {
 | `rowNumber`             | `string`  | Row number for single row operations  |
 | `addSheet`              | `object`  | Config for CREATE_WORKSHEET action    |
 
+## 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
 
 ### Use extractFirstRowHeader for Objects

package/src/integrations/gsheets/client.ts

@@ -8,7 +8,7 @@ import type { z } from "zod";
 import type { PartialMessage } from "@bufbuild/protobuf";
 import type { Plugin as GSheetsPlugin } from "@superblocksteam/types/dist/src/plugins/gsheets/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 {
@@ -96,12 +96,15 @@ export class GoogleSheetsClientImpl
     action: GoogleSheetsAction,
     schema: z.ZodSchema<T>,
     params: GoogleSheetsParams,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     const request = this.buildRequest(action, params);
 
     try {
       const result = await this.executeQuery(
         request as Record<string, unknown>,
+        undefined,
+        metadata,
       );
 
       // Validate result against schema

package/src/integrations/gsheets/types.ts

@@ -4,6 +4,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * Google Sheets action types.
@@ -96,5 +97,6 @@ export interface GoogleSheetsClient extends BaseIntegrationClient {
     action: GoogleSheetsAction,
     schema: z.ZodSchema<T>,
     params: GoogleSheetsParams,
+    metadata?: TraceMetadata,
   ): Promise<T>;
 }

package/src/integrations/hubspot/README.md

@@ -4,9 +4,9 @@ Manage contacts, deals, companies, and interact with HubSpot's CRM platform.
 
 ## Methods
 
-| Method                        | Description                                         |
-| ----------------------------- | --------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any HubSpot API request with schema validation |
+| Method                                   | Description                                         |
+| ---------------------------------------- | --------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any HubSpot API request with schema validation |
 
 ## Usage
 
@@ -281,6 +281,10 @@ const engagements = await ctx.integrations.hubspot.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/index.ts

@@ -167,6 +167,7 @@ export {
   type SupportedPluginId,
   type QueryExecutor,
   type StreamingQueryExecutor,
+  type TraceMetadata,
   type CreateClientOptions,
 } from "./registry.js";
 

package/src/integrations/intercom/README.md

@@ -4,9 +4,9 @@ Manage customer conversations, contacts, and support workflows with Intercom.
 
 ## Methods
 
-| Method                        | Description                                          |
-| ----------------------------- | ---------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Intercom API request with schema validation |
+| Method                                   | Description                                          |
+| ---------------------------------------- | ---------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Intercom API request with schema validation |
 
 ## Usage
 
@@ -239,6 +239,10 @@ const result = await ctx.integrations.intercom.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/jira/README.md

@@ -4,9 +4,9 @@ Create issues, search projects, and manage work in Jira.
 
 ## Methods
 
-| Method                        | Description                                      |
-| ----------------------------- | ------------------------------------------------ |
-| `apiRequest(options, schema)` | Make any Jira API request with schema validation |
+| Method                                   | Description                                      |
+| ---------------------------------------- | ------------------------------------------------ |
+| `apiRequest(options, schema, metadata?)` | Make any Jira API request with schema validation |
 
 ## Usage
 
@@ -285,6 +285,10 @@ const result = await ctx.integrations.jira.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/kafka/README.md

@@ -4,10 +4,10 @@ Interact with Apache Kafka with full type safety and runtime validation.
 
 ## Methods
 
-| Method                    | Description                         |
-| ------------------------- | ----------------------------------- |
-| `consume(schema, params)` | Consume messages from a Kafka topic |
-| `produce(schema, params)` | Produce messages to Kafka topics    |
+| Method                               | Description                         |
+| ------------------------------------ | ----------------------------------- |
+| `consume(schema, params, metadata?)` | Consume messages from a Kafka topic |
+| `produce(schema, params, metadata?)` | Produce messages to Kafka topics    |
 
 ## Usage
 
@@ -112,6 +112,10 @@ const result = await ctx.integrations.kafka.produce(ProduceResultSchema, {
 | `clientId`        | `string`                                | Client ID                     |
 | `timeout`         | `number`                                | Timeout in milliseconds       |
 
+## 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.
+
 ## Error Handling
 
 ```typescript

package/src/integrations/kafka/client.ts

@@ -6,7 +6,7 @@
 
 import type { z } from "zod";
 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 {
@@ -161,10 +161,13 @@ export class KafkaClientImpl implements KafkaClient, IntegrationClientImpl {
     request: KafkaRequest,
     schema: z.ZodSchema<T>,
     operation: string,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     try {
       const result = await this.executeQuery(
         request as unknown as Record<string, unknown>,
+        undefined,
+        metadata,
       );
 
       const parseResult = schema.safeParse(result);
@@ -195,16 +198,18 @@ export class KafkaClientImpl implements KafkaClient, IntegrationClientImpl {
   async consume<T>(
     schema: z.ZodSchema<T>,
     params: KafkaConsumeParams,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     const request = this.buildConsumeRequest(params);
-    return this.executeAndValidate(request, schema, "consume");
+    return this.executeAndValidate(request, schema, "consume", metadata);
   }
 
   async produce<T>(
     schema: z.ZodSchema<T>,
     params: KafkaProduceParams,
+    metadata?: TraceMetadata,
   ): Promise<T> {
     const request = this.buildProduceRequest(params);
-    return this.executeAndValidate(request, schema, "produce");
+    return this.executeAndValidate(request, schema, "produce", metadata);
   }
 }

package/src/integrations/kafka/types.ts

@@ -4,6 +4,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * Kafka operation types.
@@ -104,14 +105,23 @@ export interface KafkaClient extends BaseIntegrationClient {
    * @param params - Consume parameters
    * @returns The validated result
    */
-  consume<T>(schema: z.ZodSchema<T>, params: KafkaConsumeParams): Promise<T>;
+  consume<T>(
+    schema: z.ZodSchema<T>,
+    params: KafkaConsumeParams,
+    metadata?: TraceMetadata,
+  ): Promise<T>;
 
   /**
    * Produce messages to Kafka.
    *
    * @param schema - Zod schema for validating the result
    * @param params - Produce parameters
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The validated result
    */
-  produce<T>(schema: z.ZodSchema<T>, params: KafkaProduceParams): Promise<T>;
+  produce<T>(
+    schema: z.ZodSchema<T>,
+    params: KafkaProduceParams,
+    metadata?: TraceMetadata,
+  ): Promise<T>;
 }

package/src/integrations/kinesis/README.md

@@ -4,10 +4,10 @@ Write records to and read records from Amazon Kinesis Data Streams.
 
 ## Methods
 
-| Method               | Description                               |
-| -------------------- | ----------------------------------------- |
-| `putRecord(params)`  | Write a single record to a Kinesis stream |
-| `getRecords(params)` | Read records from a Kinesis stream shard  |
+| Method                          | Description                               |
+| ------------------------------- | ----------------------------------------- |
+| `putRecord(params, metadata?)`  | Write a single record to a Kinesis stream |
+| `getRecords(params, metadata?)` | Read records from a Kinesis stream shard  |
 
 ## Usage
 
@@ -124,6 +124,10 @@ const records = await kinesis.getRecords({
 | `TRIM_HORIZON`          | Start at the oldest record in the shard   |
 | `LATEST`                | Start at the most recent record           |
 
+## 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.
+
 ## Error Handling
 
 ```typescript

package/src/integrations/kinesis/client.ts

@@ -6,7 +6,7 @@
  */
 
 import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
-import type { QueryExecutor } from "../registry.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
 import { IntegrationError } from "../../runtime/errors.js";
 import type {
   KinesisClient,
@@ -53,9 +53,10 @@ export class KinesisClientImpl implements KinesisClient, IntegrationClientImpl {
   private async exec(
     request: Record<string, unknown>,
     operation: string,
+    metadata?: TraceMetadata,
   ): Promise<unknown> {
     try {
-      return await this.executeQuery(request);
+      return await this.executeQuery(request, undefined, metadata);
     } catch (error) {
       if (error instanceof IntegrationError) {
         throw error;
@@ -65,7 +66,10 @@ export class KinesisClientImpl implements KinesisClient, IntegrationClientImpl {
     }
   }
 
-  async putRecord(params: KinesisPutParams): Promise<unknown> {
+  async putRecord(
+    params: KinesisPutParams,
+    metadata?: TraceMetadata,
+  ): Promise<unknown> {
     const put: Record<string, unknown> = {
       data: params.data,
       partitionKey: params.partitionKey,
@@ -89,10 +93,14 @@ export class KinesisClientImpl implements KinesisClient, IntegrationClientImpl {
         put,
       },
       "putRecord",
+      metadata,
     );
   }
 
-  async getRecords(params: KinesisGetParams): Promise<unknown> {
+  async getRecords(
+    params: KinesisGetParams,
+    metadata?: TraceMetadata,
+  ): Promise<unknown> {
     const get: Record<string, unknown> = {
       shardId: params.shardId,
       shardIteratorType: params.shardIteratorType,
@@ -132,6 +140,7 @@ export class KinesisClientImpl implements KinesisClient, IntegrationClientImpl {
         get,
       },
       "getRecords",
+      metadata,
     );
   }
 }

package/src/integrations/kinesis/types.ts

@@ -5,6 +5,7 @@
  */
 
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * Stream identifier type for Kinesis operations.
@@ -94,13 +95,20 @@ export interface KinesisClient extends BaseIntegrationClient {
    * @param params - PUT operation parameters
    * @returns The raw result from Kinesis (includes ShardId and SequenceNumber)
    */
-  putRecord(params: KinesisPutParams): Promise<unknown>;
+  putRecord(
+    params: KinesisPutParams,
+    metadata?: TraceMetadata,
+  ): Promise<unknown>;
 
   /**
    * Get records from a Kinesis stream shard.
    *
    * @param params - GET operation parameters
+   * @param metadata - Optional trace metadata for diagnostics
    * @returns The raw result from Kinesis (includes Records array)
    */
-  getRecords(params: KinesisGetParams): Promise<unknown>;
+  getRecords(
+    params: KinesisGetParams,
+    metadata?: TraceMetadata,
+  ): Promise<unknown>;
 }

package/src/integrations/lakebase/client.ts

@@ -9,7 +9,7 @@ import type { z } from "zod";
 import type { PartialMessage } from "@bufbuild/protobuf";
 import type { Plugin as LakebasePlugin } from "@superblocksteam/types/dist/src/plugins/lakebase/v1/plugin_pb";
 import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
-import type { QueryExecutor } from "../registry.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
 import type { LakebaseClient } from "./types.js";
 import { QueryValidationError } from "../../errors.js";
 import { IntegrationError } from "../../runtime/errors.js";
@@ -62,12 +62,15 @@ export class LakebaseClientImpl
     sql: string,
     schema: z.ZodSchema<T>,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<T[]> {
     const request = this.buildRequest(sql, params);
 
     try {
       const result = await this.executeQuery(
         request as Record<string, unknown>,
+        undefined,
+        metadata,
       );
 
       if (!Array.isArray(result)) {
@@ -113,12 +116,15 @@ export class LakebaseClientImpl
   async execute(
     sql: string,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<{ rowCount: number }> {
     const request = this.buildRequest(sql, params);
 
     try {
       const result = await this.executeQuery(
         request as Record<string, unknown>,
+        undefined,
+        metadata,
       );
 
       if (

package/src/integrations/lakebase/types.ts

@@ -7,6 +7,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * Lakebase client for SQL query and execute operations.
@@ -42,6 +43,7 @@ export interface LakebaseClient extends BaseIntegrationClient {
     sql: string,
     schema: z.ZodSchema<T>,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<T[]>;
 
   /**
@@ -51,5 +53,9 @@ export interface LakebaseClient extends BaseIntegrationClient {
    * @param params - Optional query parameters for server-side binding
    * @returns The affected row count
    */
-  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>;
+  execute(
+    sql: string,
+    params?: unknown[],
+    metadata?: TraceMetadata,
+  ): Promise<{ rowCount: number }>;
 }

package/src/integrations/launchdarkly/README.md

@@ -4,9 +4,9 @@ Manage feature flags, get flag evaluations, and interact with LaunchDarkly's fea
 
 ## Methods
 
-| Method                        | Description                                              |
-| ----------------------------- | -------------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any LaunchDarkly API request with schema validation |
+| Method                                   | Description                                              |
+| ---------------------------------------- | -------------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any LaunchDarkly API request with schema validation |
 
 ## Usage
 
@@ -296,6 +296,10 @@ const result = await ctx.integrations.launchdarkly.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/mariadb/README.md

@@ -4,10 +4,10 @@ Execute SQL queries and statements against MariaDB databases with full type safe
 
 ## Methods
 
-| Method                           | Description                                                                |
-| -------------------------------- | -------------------------------------------------------------------------- |
-| `query<T>(sql, schema, params?)` | Execute a SELECT query and return validated, typed results                 |
-| `execute(sql, params?)`          | Execute a statement (INSERT, UPDATE, DELETE) and return affected row count |
+| Method                                      | Description                                                                |
+| ------------------------------------------- | -------------------------------------------------------------------------- |
+| `query<T>(sql, schema, params?, metadata?)` | Execute a SELECT query and return validated, typed results                 |
+| `execute(sql, params?, metadata?)`          | Execute a statement (INSERT, UPDATE, DELETE) and return affected row count |
 
 ## Usage
 
@@ -72,6 +72,10 @@ const deleteResult = await ctx.integrations.mariadb.execute(
 console.log(`Deleted ${deleteResult.rowCount} expired sessions`);
 ```
 
+## 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
 
 ### BIGINT Values Returned as Strings

package/src/integrations/mariadb/client.ts

@@ -9,7 +9,7 @@ import type { z } from "zod";
 import type { PartialMessage } from "@bufbuild/protobuf";
 import type { Plugin as MariaDBPlugin } from "@superblocksteam/types/dist/src/plugins/mariadb/v1/plugin_pb";
 import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
-import type { QueryExecutor } from "../registry.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
 import { QueryValidationError } from "../../errors.js";
 import { IntegrationError } from "../../runtime/errors.js";
 import { describeType } from "../utils.js";
@@ -62,11 +62,12 @@ export class MariaDBClientImpl implements MariaDBClient, IntegrationClientImpl {
     sql: string,
     schema: z.ZodSchema<T>,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<T[]> {
     const request = this.buildRequest(sql, params);
 
     try {
-      const result = await this.executeQuery(request);
+      const result = await this.executeQuery(request, undefined, metadata);
 
       if (!Array.isArray(result)) {
         throw new IntegrationError(
@@ -114,11 +115,12 @@ export class MariaDBClientImpl implements MariaDBClient, IntegrationClientImpl {
   async execute(
     sql: string,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<{ rowCount: number }> {
     const request = this.buildRequest(sql, params);
 
     try {
-      const result = await this.executeQuery(request);
+      const result = await this.executeQuery(request, undefined, metadata);
 
       if (
         typeof result === "object" &&

package/src/integrations/mariadb/types.ts

@@ -6,6 +6,7 @@
 
 import type { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
 
 /**
  * Client for executing MariaDB queries with type-safe validation.
@@ -45,6 +46,7 @@ export interface MariaDBClient extends BaseIntegrationClient {
     sql: string,
     schema: z.ZodSchema<T>,
     params?: unknown[],
+    metadata?: TraceMetadata,
   ): Promise<T[]>;
 
   /**
@@ -54,5 +56,9 @@ export interface MariaDBClient extends BaseIntegrationClient {
    * @param params - Optional parameters for prepared statements
    * @returns Promise resolving to execution result with row count
    */
-  execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }>;
+  execute(
+    sql: string,
+    params?: unknown[],
+    metadata?: TraceMetadata,
+  ): Promise<{ rowCount: number }>;
 }

package/src/integrations/mistral/README.md

@@ -4,9 +4,9 @@ Interact with Mistral AI's APIs for chat completions, embeddings, and code gener
 
 ## Methods
 
-| Method                        | Description                                         |
-| ----------------------------- | --------------------------------------------------- |
-| `apiRequest(options, schema)` | Make any Mistral API request with schema validation |
+| Method                                   | Description                                         |
+| ---------------------------------------- | --------------------------------------------------- |
+| `apiRequest(options, schema, metadata?)` | Make any Mistral API request with schema validation |
 
 ## Usage
 
@@ -245,6 +245,10 @@ const result = await ctx.integrations.mistral.apiRequest(
 const data = JSON.parse(result.choices[0]?.message.content ?? "{}");
 ```
 
+## 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