@agirails/sdk 2.0.2 → 2.0.4

package/src/adapters/{BeginnerAdapter.ts → BasicAdapter.ts}

@@ -1,5 +1,5 @@
 /**
- * BeginnerAdapter - High-level, opinionated API for simple use cases
+ * BasicAdapter - High-level, opinionated API for simple use cases
  *
  * Provides the simplest possible interface for creating and checking transactions.
  * Designed for developers who want to "just make it work" without deep protocol knowledge.
@@ -10,20 +10,19 @@
  * - User-friendly input (strings, no BigInt)
  * - User-friendly output (formatted amounts, ISO dates)
  *
- * @module adapters/BeginnerAdapter
+ * @module adapters/BasicAdapter
  */
 
-import { BaseAdapter, ValidationError, DEFAULT_DISPUTE_WINDOW_SECONDS } from './BaseAdapter';
+import { BaseAdapter, ValidationError } from './BaseAdapter';
 import { IACTPRuntime } from '../runtime/IACTPRuntime';
-import { TransactionState } from '../runtime/types/MockState';
 import { EASHelper } from '../protocol/EASHelper';
 
 /**
  * Parameters for creating a simple payment.
  *
- * This is the most beginner-friendly interface - minimal required fields.
+ * This is the most user-friendly interface - minimal required fields.
  */
-export interface BeginnerPayParams {
+export interface BasicPayParams {
   /** Recipient address (provider) */
   to: string;
 
@@ -42,7 +41,7 @@ export interface BeginnerPayParams {
  *
  * Provides user-friendly formatted data (not raw protocol types).
  */
-export interface BeginnerPayResult {
+export interface BasicPayResult {
   /** Transaction ID (bytes32 hex string) */
   txId: string;
 
@@ -63,7 +62,7 @@ export interface BeginnerPayResult {
 }
 
 /**
- * BeginnerAdapter - High-level API for simple payment flows.
+ * BasicAdapter - High-level API for simple payment flows.
  *
  * This adapter provides the simplest possible interface:
  * - `pay()` - Create and fund a transaction in one call
@@ -76,7 +75,7 @@ export interface BeginnerPayResult {
  * const client = await ACTPClient.create({ mode: 'mock' });
  *
  * // Simple payment (all defaults)
- * const result = await client.beginner.pay({
+ * const result = await client.basic.pay({
  *   to: '0xProvider123',
  *   amount: '100',
  * });
@@ -84,15 +83,15 @@ export interface BeginnerPayResult {
  * console.log('Amount:', result.amount); // "100.00 USDC"
  *
  * // Check status
- * const status = await client.beginner.checkStatus(result.txId);
+ * const status = await client.basic.checkStatus(result.txId);
  * if (status.canAccept) {
  *   console.log('Provider can accept this transaction');
  * }
  * ```
  */
-export class BeginnerAdapter extends BaseAdapter {
+export class BasicAdapter extends BaseAdapter {
   /**
-   * Creates a new BeginnerAdapter instance.
+   * Creates a new BasicAdapter instance.
    *
    * @param runtime - ACTP runtime implementation (MockRuntime or BlockchainRuntime)
    * @param requesterAddress - The requester's Ethereum address
@@ -136,7 +135,7 @@ export class BeginnerAdapter extends BaseAdapter {
    * });
    * ```
    */
-  async pay(params: BeginnerPayParams): Promise<BeginnerPayResult> {
+  async pay(params: BasicPayParams): Promise<BasicPayResult> {
     // Validate and parse inputs
     const provider = this.validateAddress(params.to, 'to');
     const amount = this.parseAmount(params.amount);

package/src/adapters/{IntermediateAdapter.ts → StandardAdapter.ts}

@@ -1,7 +1,7 @@
 /**
- * IntermediateAdapter - Balanced API for developers with some protocol knowledge
+ * StandardAdapter - Balanced API for developers with some protocol knowledge
  *
- * Provides more control than BeginnerAdapter while still offering convenience:
+ * Provides more control than BasicAdapter while still offering convenience:
  * - Explicit transaction lifecycle methods
  * - Direct escrow operations
  * - State transition control
@@ -9,20 +9,20 @@
  * Use this adapter when you need fine-grained control but still want
  * user-friendly input parsing and validation.
  *
- * @module adapters/IntermediateAdapter
+ * @module adapters/StandardAdapter
  */
 
-import { BaseAdapter, ValidationError, DEFAULT_DISPUTE_WINDOW_SECONDS } from './BaseAdapter';
+import { BaseAdapter, ValidationError } from './BaseAdapter';
 import { IACTPRuntime } from '../runtime/IACTPRuntime';
 import { MockTransaction, TransactionState } from '../runtime/types/MockState';
 import { EASHelper } from '../protocol/EASHelper';
 
 /**
- * Parameters for creating a transaction (intermediate level).
+ * Parameters for creating a transaction (standard level).
  *
- * More explicit than BeginnerPayParams but still with smart defaults.
+ * More explicit than BasicPayParams but still with smart defaults.
  */
-export interface IntermediateTransactionParams {
+export interface StandardTransactionParams {
   /** Provider's Ethereum address */
   provider: string;
 
@@ -40,7 +40,7 @@ export interface IntermediateTransactionParams {
 }
 
 /**
- * IntermediateAdapter - Balanced API for transaction lifecycle control.
+ * StandardAdapter - Balanced API for transaction lifecycle control.
  *
  * Provides explicit methods for each stage of the ACTP lifecycle:
  * - `createTransaction()` - Create transaction without escrow
@@ -55,25 +55,25 @@ export interface IntermediateTransactionParams {
  * const client = await ACTPClient.create({ mode: 'mock' });
  *
  * // Create transaction (INITIATED state)
- * const txId = await client.intermediate.createTransaction({
+ * const txId = await client.standard.createTransaction({
  *   provider: '0xProvider123',
  *   amount: '100',
  *   deadline: '+7d',
  * });
  *
  * // Link escrow (auto-transitions to COMMITTED)
- * await client.intermediate.linkEscrow(txId, '100');
+ * await client.standard.linkEscrow(txId, '100');
  *
  * // Provider delivers
- * await client.intermediate.transitionState(txId, 'DELIVERED');
+ * await client.standard.transitionState(txId, 'DELIVERED');
  *
  * // Release funds after dispute window
- * await client.intermediate.releaseEscrow(escrowId);
+ * await client.standard.releaseEscrow(escrowId);
  * ```
  */
-export class IntermediateAdapter extends BaseAdapter {
+export class StandardAdapter extends BaseAdapter {
   /**
-   * Creates a new IntermediateAdapter instance.
+   * Creates a new StandardAdapter instance.
    *
    * @param runtime - ACTP runtime implementation (MockRuntime or BlockchainRuntime)
    * @param requesterAddress - The requester's Ethereum address
@@ -90,7 +90,7 @@ export class IntermediateAdapter extends BaseAdapter {
   /**
    * Create a transaction (INITIATED state, no escrow yet).
    *
-   * Unlike `beginner.pay()`, this only creates the transaction
+   * Unlike `basic.pay()`, this only creates the transaction
    * without linking escrow. You must call `linkEscrow()` separately.
    *
    * @param params - Transaction parameters
@@ -106,7 +106,7 @@ export class IntermediateAdapter extends BaseAdapter {
    * });
    * ```
    */
-  async createTransaction(params: IntermediateTransactionParams): Promise<string> {
+  async createTransaction(params: StandardTransactionParams): Promise<string> {
     const provider = this.validateAddress(params.provider, 'provider');
     const amount = this.parseAmount(params.amount);
     const currentTime = this.runtime.time.now();

package/src/adapters/index.ts

@@ -3,8 +3,8 @@
  *
  * This module exports all adapter classes and types for the Three-Level API:
  * - BaseAdapter: Abstract base with shared utilities
- * - BeginnerAdapter: High-level, opinionated API
- * - IntermediateAdapter: Balanced control API
+ * - BasicAdapter: High-level, opinionated API
+ * - StandardAdapter: Balanced control API
  *
  * @module adapters
  */
@@ -18,8 +18,8 @@ export {
   MAX_DEADLINE_HOURS,
   MAX_DEADLINE_DAYS,
 } from './BaseAdapter';
-export { BeginnerAdapter, BeginnerPayParams, BeginnerPayResult } from './BeginnerAdapter';
-export { IntermediateAdapter, IntermediateTransactionParams } from './IntermediateAdapter';
+export { BasicAdapter, BasicPayParams, BasicPayResult } from './BasicAdapter';
+export { StandardAdapter, StandardTransactionParams } from './StandardAdapter';
 
 // Re-export runtime interface for convenience
 export { IACTPRuntime, CreateTransactionParams } from '../runtime/IACTPRuntime';

package/src/builders/QuoteBuilder.ts

@@ -233,7 +233,7 @@ export class QuoteBuilder {
    */
   computeHash(quote: QuoteMessage): string {
     // Remove signature field for hashing
-    const { signature, ...quoteWithoutSig } = quote;
+    const { signature: _signature, ...quoteWithoutSig } = quote;
     return keccak256(toUtf8Bytes(canonicalJsonStringify(quoteWithoutSig)));
   }
 

package/src/cli/commands/config.ts

@@ -156,7 +156,7 @@ function createConfigSetCommand(): Command {
           updates.address = value.toLowerCase();
         }
 
-        const newConfig = updateConfig(updates);
+        updateConfig(updates);
 
         output.result({
           [key]: key === 'privateKey' ? '****' + value.slice(-4) : value,

package/src/cli/commands/pay.ts

@@ -1,5 +1,5 @@
 /**
- * Pay Command - One-liner payment command (beginner API)
+ * Pay Command - One-liner payment command (basic API)
  *
  * The simplest way to create a payment transaction.
  * Creates transaction, links escrow, and returns immediately.
@@ -76,7 +76,7 @@ async function runPay(
     const disputeWindow = parseInt(options.disputeWindow, 10);
 
     // Create payment
-    const result = await client.beginner.pay({
+    const result = await client.basic.pay({
       to,
       amount,
       deadline,

package/src/cli/commands/simulate.ts

@@ -14,7 +14,7 @@ import { Command } from 'commander';
 import { Output, ExitCode, fmt } from '../utils/output';
 import { loadConfig } from '../utils/config';
 import { mapError } from '../utils/client';
-import { BaseAdapter, ValidationError, MIN_AMOUNT_WEI } from '../../adapters/BaseAdapter';
+import { BaseAdapter } from '../../adapters/BaseAdapter';
 
 // ============================================================================
 // Command Definition

package/src/cli/commands/time.ts

@@ -10,10 +10,9 @@
  */
 
 import { Command } from 'commander';
-import { Output, ExitCode, fmt } from '../utils/output';
+import { Output, ExitCode } from '../utils/output';
 import { loadConfig } from '../utils/config';
 import { createClient, mapError } from '../utils/client';
-import { MockRuntime } from '../../runtime/MockRuntime';
 import { IMockRuntime } from '../../runtime/IACTPRuntime';
 
 // ============================================================================

package/src/cli/commands/tx.ts

@@ -2,7 +2,7 @@
  * Transaction Commands - tx subcommand group
  *
  * Commands for managing ACTP transactions:
- * - tx create: Create a new transaction (intermediate API)
+ * - tx create: Create a new transaction (standard API)
  * - tx status: Check transaction status
  * - tx list: List all transactions
  * - tx deliver: Mark transaction as delivered
@@ -66,7 +66,7 @@ function createTxCreateCommand(): Command {
         const disputeWindow = parseInt(options.disputeWindow, 10);
 
         // Create transaction
-        const txId = await client.intermediate.createTransaction({
+        const txId = await client.standard.createTransaction({
           provider,
           amount,
           deadline,
@@ -77,10 +77,10 @@ function createTxCreateCommand(): Command {
         // Optionally fund
         let escrowId: string | undefined;
         if (options.fund) {
-          escrowId = await client.intermediate.linkEscrow(txId);
+          escrowId = await client.standard.linkEscrow(txId);
         }
 
-        const tx = await client.intermediate.getTransaction(txId);
+        const tx = await client.standard.getTransaction(txId);
         if (!tx) throw new Error('Transaction not found after creation');
 
         output.result(
@@ -134,13 +134,13 @@ function createTxStatusCommand(): Command {
         }
 
         const client = await createClient();
-        const tx = await client.intermediate.getTransaction(txId);
+        const tx = await client.standard.getTransaction(txId);
 
         if (!tx) {
           throw new Error(`Transaction not found: ${txId}`);
         }
 
-        const status = await client.beginner.checkStatus(txId);
+        const status = await client.basic.checkStatus(txId);
 
         if (options.quiet) {
           output.raw(tx.state);
@@ -289,9 +289,9 @@ function createTxDeliverCommand(): Command {
         const client = await createClient();
 
         // Transition to DELIVERED
-        await client.intermediate.transitionState(txId, 'DELIVERED' as TransactionState);
+        await client.standard.transitionState(txId, 'DELIVERED' as TransactionState);
 
-        const tx = await client.intermediate.getTransaction(txId);
+        const tx = await client.standard.getTransaction(txId);
         if (!tx) throw new Error('Transaction not found');
 
         output.result(
@@ -345,15 +345,15 @@ function createTxSettleCommand(): Command {
         const client = await createClient();
 
         // Get transaction to find escrow
-        const tx = await client.intermediate.getTransaction(txId);
+        const tx = await client.standard.getTransaction(txId);
         if (!tx) throw new Error(`Transaction not found: ${txId}`);
         if (!tx.escrowId) throw new Error('Transaction has no linked escrow');
 
         // Release escrow
-        await client.intermediate.releaseEscrow(tx.escrowId);
+        await client.standard.releaseEscrow(tx.escrowId);
 
         // Get updated transaction
-        const updatedTx = await client.intermediate.getTransaction(txId);
+        const updatedTx = await client.standard.getTransaction(txId);
         if (!updatedTx) throw new Error('Transaction not found');
 
         output.result(
@@ -402,9 +402,9 @@ function createTxCancelCommand(): Command {
         const client = await createClient();
 
         // Transition to CANCELLED
-        await client.intermediate.transitionState(txId, 'CANCELLED' as TransactionState);
+        await client.standard.transitionState(txId, 'CANCELLED' as TransactionState);
 
-        const tx = await client.intermediate.getTransaction(txId);
+        const tx = await client.standard.getTransaction(txId);
         if (!tx) throw new Error('Transaction not found');
 
         output.result(

package/src/cli/commands/watch.ts

@@ -85,7 +85,7 @@ async function runWatch(
   }
 
   // Get initial state
-  const tx = await client.intermediate.getTransaction(txId);
+  const tx = await client.standard.getTransaction(txId);
   if (!tx) {
     throw new Error(`Transaction not found: ${txId}`);
   }
@@ -123,7 +123,7 @@ async function runWatch(
     }
 
     try {
-      const updatedTx = await client.intermediate.getTransaction(txId);
+      const updatedTx = await client.standard.getTransaction(txId);
       if (!updatedTx) {
         output.warning('Transaction no longer exists');
         process.exit(ExitCode.ERROR);

package/src/index.ts

@@ -20,7 +20,7 @@
  * await client.mintTokens(client.getAddress(), '10000000000');
  *
  * // Create a payment
- * const result = await client.beginner.pay({
+ * const result = await client.basic.pay({
  *   to: '0xProvider...',
  *   amount: '100',
  * });
@@ -54,15 +54,15 @@ export {
 } from './adapters/BaseAdapter';
 
 export {
-  BeginnerAdapter,
-  BeginnerPayParams,
-  BeginnerPayResult,
-} from './adapters/BeginnerAdapter';
+  BasicAdapter,
+  BasicPayParams,
+  BasicPayResult,
+} from './adapters/BasicAdapter';
 
 export {
-  IntermediateAdapter,
-  IntermediateTransactionParams,
-} from './adapters/IntermediateAdapter';
+  StandardAdapter,
+  StandardTransactionParams,
+} from './adapters/StandardAdapter';
 
 // =============================================================================
 // Runtime Layer - Protocol Implementation

package/src/level0/request.ts

@@ -164,7 +164,6 @@ export async function request(
 
     let tx = await client.runtime.getTransaction(txId);
     let attempts = 0;
-    let timedOut = false;
 
     while (tx && tx.state !== 'DELIVERED' && tx.state !== 'SETTLED' && attempts < maxAttempts) {
       // Check for terminal states that indicate failure
@@ -190,7 +189,7 @@ export async function request(
 
     // Check if we got a result
     if (!tx || (tx.state !== 'DELIVERED' && tx.state !== 'SETTLED')) {
-      timedOut = true;
+      const _timedOut = true; // Flag for potential future use
 
       // SECURITY FIX (H-3): Auto-cancel transaction on timeout if still in early state
       // This prevents funds from being locked indefinitely if provider never responds

package/src/level1/Agent.ts

@@ -14,10 +14,10 @@ import * as fs from 'fs';
 import { ethers } from 'ethers';
 import { ACTPClient } from '../ACTPClient';
 import { Job, JobHandler, JobContext } from './types/Job';
-import { ProvideOptions, RequestOptions, RequestResult, NetworkOption } from './types/Options';
+import { RequestOptions, RequestResult, NetworkOption } from './types/Options';
 import { PricingStrategy } from './pricing/PricingStrategy';
 import { AgentLifecycleError, ServiceConfigError, ValidationError } from '../errors';
-import { validateServiceName, validatePath, isValidAddress, LRUCache } from '../utils/security';
+import { validateServiceName, validatePath, LRUCache } from '../utils/security';
 import { Logger } from '../utils/Logger';
 import { ServiceHash } from '../utils/Helpers';
 import { Semaphore } from '../utils/Semaphore';

package/src/level1/pricing/PriceCalculator.ts

@@ -214,7 +214,7 @@ function estimateUnits(job: Job, unit: string): number {
  *
  * @internal
  */
-function estimateApiCost(api: string, job: Job): number {
+function estimateApiCost(_api: string, _job: Job): number {
   // MVP: Returns 0 (API costs tracked externally by agent)
   // V2: Integrate with OpenAI/Anthropic pricing APIs
 

package/src/level1/types/Options.ts

@@ -4,7 +4,7 @@
  * @packageDocumentation
  */
 
-import { JobHandler, Job } from './Job';
+import { Job } from './Job';
 
 /**
  * Wallet configuration options

package/src/protocol/ACTPKernel.ts

@@ -455,13 +455,13 @@ export class ACTPKernel {
    *
    * **REQUIRED: Use secure wrapper methods instead:**
    *
-   * 1. **BeginnerAdapter.completePayment()** (recommended for most users)
+   * 1. **BasicAdapter.completePayment()** (recommended for most users)
    *    - Automatically verifies attestation before release
    *    - Validates attestation belongs to this transaction
    *    - Checks attestation hasn't been used before
    *    - Handles all state transitions
    *
-   * 2. **IntermediateAdapter.releaseEscrow()** (for more control)
+   * 2. **StandardAdapter.releaseEscrow()** (for more control)
    *    - Explicitly requires attestation verification
    *    - Throws error if attestation invalid or missing
    *    - Allows custom verification logic
@@ -493,15 +493,15 @@ export class ACTPKernel {
    *
    * **For testnet/mainnet deployments:**
    * - MUST configure easConfig in ACTPClient
-   * - MUST use wrapper methods (Beginner/Intermediate adapters)
+   * - MUST use wrapper methods (Basic/Standard adapters)
    * - NEVER call this method directly unless attestation verified
    *
    * @param txId - Transaction ID to settle
    * @throws {ValidationError} If txId is invalid
    * @throws {TransactionRevertedError} If contract reverts
    *
-   * @see {@link BeginnerAdapter.completePayment} Recommended method with built-in verification
-   * @see {@link IntermediateAdapter.releaseEscrow} Explicit verification method
+   * @see {@link BasicAdapter.completePayment} Recommended method with built-in verification
+   * @see {@link StandardAdapter.releaseEscrow} Explicit verification method
    * @see {@link EASHelper.verifyDeliveryAttestation} Manual verification helper
    */
   async releaseEscrow(txId: string): Promise<void> {

package/src/protocol/MessageSigner.ts

@@ -157,7 +157,7 @@ export class MessageSigner {
       );
     }
 
-    const { type, version, from, to, timestamp, nonce, signature, ...payload } = message;
+    const { type, version, from, to, timestamp, nonce, signature: _sig, ...payload } = message;
 
     // SECURITY FIX (H-3): Validate nonce format (must be bytes32)
     if (!nonce || !/^0x[a-fA-F0-9]{64}$/.test(nonce)) {

package/src/protocol/ProofGenerator.ts

@@ -230,6 +230,7 @@ export class ProofGenerator {
           throw new Error('Response body is not readable');
         }
 
+        // eslint-disable-next-line no-constant-condition
         while (true) {
           const { done, value } = await reader.read();
 

package/src/runtime/BlockchainRuntime.ts

@@ -84,7 +84,7 @@ export interface BlockchainRuntimeConfig {
  * });
  *
  * // Now use with adapters
- * const adapter = new BeginnerAdapter(runtime, requesterAddress);
+ * const adapter = new BasicAdapter(runtime, requesterAddress);
  * await adapter.createJob({...});
  * ```
  */
@@ -892,7 +892,7 @@ export class BlockchainRuntime implements IACTPRuntime {
    * @param params - Transaction parameters
    * @returns Estimated gas limit and cost in wei
    */
-  async estimateCreateTransactionGas(params: CreateTransactionParams): Promise<{
+  async estimateCreateTransactionGas(_params: CreateTransactionParams): Promise<{
     gasLimit: bigint;
     gasCostWei: bigint;
     gasCostGwei: string;
@@ -921,7 +921,7 @@ export class BlockchainRuntime implements IACTPRuntime {
    * @param txId - Transaction ID
    * @returns Estimated gas limit and cost
    */
-  async estimateLinkEscrowGas(txId: string): Promise<{
+  async estimateLinkEscrowGas(_txId: string): Promise<{
     gasLimit: bigint;
     gasCostWei: bigint;
     gasCostGwei: string;
@@ -949,7 +949,7 @@ export class BlockchainRuntime implements IACTPRuntime {
    * @param newState - Target state
    * @returns Estimated gas limit and cost
    */
-  async estimateTransitionGas(txId: string, newState: string): Promise<{
+  async estimateTransitionGas(_txId: string, _newState: string): Promise<{
     gasLimit: bigint;
     gasCostWei: bigint;
     gasCostGwei: string;

package/src/runtime/IACTPRuntime.ts

@@ -49,7 +49,7 @@ export interface CreateTransactionParams {
  * });
  *
  * // Adapters work with either implementation
- * const adapter = new BeginnerAdapter(runtime, requesterAddress);
+ * const adapter = new BasicAdapter(runtime, requesterAddress);
  * ```
  */
 export interface IACTPRuntime {

package/src/runtime/MockRuntime.ts

@@ -25,8 +25,6 @@ import {
   MockEscrow,
   MockEvent,
   TransactionState,
-  TransactionStateValue,
-  MOCK_STATE_DEFAULTS,
 } from './types/MockState';
 import { IACTPRuntime, CreateTransactionParams } from './IACTPRuntime';
 

package/src/utils/ErrorRecoveryGuide.ts

@@ -465,7 +465,7 @@ const DEFAULT_RECOVERY: ErrorRecoveryInfo = {
  * @example
  * ```typescript
  * try {
- *   await client.beginner.pay({ to: provider, amount: '100' });
+ *   await client.basic.pay({ to: provider, amount: '100' });
  * } catch (error) {
  *   const recovery = ErrorRecoveryGuide.analyze(error);
  *   console.log('Category:', recovery.category);
@@ -622,7 +622,7 @@ ${recovery.securityNotes.map((n) => `  ! ${n}`).join('\n')}`;
  * @example
  * ```typescript
  * const result = await withRecoveryGuidance(
- *   () => client.beginner.pay({ to: provider, amount: '100' }),
+ *   () => client.basic.pay({ to: provider, amount: '100' }),
  *   { logGuidance: true, autoRetry: true }
  * );
  * ```
@@ -637,14 +637,12 @@ export async function withRecoveryGuidance<T>(
 ): Promise<T> {
   const { logGuidance = false, autoRetry = false, onError } = options;
 
-  let lastError: unknown;
   let attempts = 0;
 
   do {
     try {
       return await operation();
     } catch (error) {
-      lastError = error;
       const recovery = ErrorRecoveryGuide.analyze(error);
 
       if (onError) {
@@ -671,5 +669,6 @@ export async function withRecoveryGuidance<T>(
 
       throw error;
     }
+    // eslint-disable-next-line no-constant-condition
   } while (true);
 }

package/src/utils/UsedAttestationTracker.ts

@@ -202,7 +202,7 @@ export class InMemoryUsedAttestationTracker implements IUsedAttestationTracker {
    *
    * @param maxAgeHours - Remove entries older than this many hours
    */
-  cleanupOldEntries(maxAgeHours: number): number {
+  cleanupOldEntries(_maxAgeHours: number): number {
     // In-memory tracker doesn't track timestamps
     // This is a placeholder for future enhancement
     console.warn(