deepline 0.1.302 → 0.1.303

package/dist/cli/index.mjs

@@ -207,33 +207,68 @@ function applyBrand(value, brand) {
   });
 }
 var DeeplineError = class _DeeplineError extends Error {
+  /** HTTP status when the failure crossed an HTTP boundary. */
+  statusCode;
+  /** Stable machine-readable error code when one exists. */
+  code;
+  /** Local diagnostic context; not a portable error contract. */
+  details;
+  /**
+   * Construct a Deepline error.
+   *
+   * SDK and runtime code construct these errors. Application and Play code
+   * normally catches the public subclasses instead.
+   *
+   * @param message Human-readable failure summary.
+   * @param statusCode HTTP status when one exists.
+   * @param code Stable machine-readable code when one exists.
+   * @param details Local diagnostic context; never a portable error contract.
+   */
   constructor(message, statusCode, code, details) {
     super(message);
+    this.name = "DeeplineError";
     this.statusCode = statusCode;
     this.code = code;
     this.details = details;
-    this.name = "DeeplineError";
     applyBrand(this, DEEPLINE_ERROR_BRAND);
   }
-  statusCode;
-  code;
-  details;
   static [Symbol.hasInstance](value) {
     if (this !== _DeeplineError) return nativeInstanceOf(this, value);
     return hasBrand(value, DEEPLINE_ERROR_BRAND);
   }
 };
 var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
+  /** Public tool id passed to `tools.execute`. */
   toolId;
+  /** Provider responsible for the operation, or `null` when unattributed. */
   provider;
+  /** Provider operation name, or `null` when unavailable. */
   operation;
+  /** Boundary responsible for the failure. */
   origin;
+  /** Stable reason family for policy and diagnostics. */
   category;
+  /**
+   * Whether repeating the same semantic call is delivery-safe.
+   *
+   * This does not mean the error may be ignored. Waterfall fallthrough is
+   * represented by `ProviderTransientError`.
+   */
   retryable;
+  /** Provider or Deepline request id, or `null` when unavailable. */
   requestId;
+  /** Suggested same-call retry delay in milliseconds, or `null`. */
   retryAfterMs;
+  /** Network failure kind, or `null` for non-network failures. */
   networkKind;
+  /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /**
+   * Construct a structured tool error.
+   *
+   * Deepline constructs this from the versioned `tool_error` payload.
+   * Application and Play code should catch it rather than create it.
+   */
   constructor(message, options) {
     super(
       message,
@@ -269,7 +304,9 @@ function isProviderTransientFailure(input2) {
   return input2.origin === "provider" && (input2.category === "rate_limit" || input2.category === "network" || input2.category === "upstream");
 }
 var ProviderTransientError = class _ProviderTransientError extends ToolExecutionError {
+  /** Provider attribution is guaranteed for this subtype. */
   origin = "provider";
+  /** Constructed by Deepline when a provider-owned transient failure arrives. */
   constructor(message, options) {
     super(message, {
       ...options,
@@ -423,6 +460,7 @@ function deserializeToolExecutionFailure(message, value, acceptedSchemaVersion)
 
 // src/errors.ts
 var AuthError = class extends DeeplineError {
+  /** Constructed by the SDK when Deepline rejects the caller's credentials. */
   constructor(message = "Authentication failed. Check your DEEPLINE_API_KEY.") {
     super(message, 401, "AUTH_ERROR");
     this.name = "AuthError";
@@ -431,6 +469,7 @@ var AuthError = class extends DeeplineError {
 var RateLimitError = class extends DeeplineError {
   /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
   retryAfterMs;
+  /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
   constructor(retryAfterMs = 5e3, message) {
     super(
       message ?? `Rate limited. Retry after ${retryAfterMs}ms.`,
@@ -442,16 +481,27 @@ var RateLimitError = class extends DeeplineError {
   }
 };
 var ToolRateLimitError = class extends RateLimitError {
+  /** Public tool id passed to `tools.execute`. */
   toolId;
+  /** Provider responsible for the operation, or `null`. */
   provider;
+  /** Provider operation name, or `null`. */
   operation;
+  /** Stable machine-readable failure code when one exists. */
   code;
+  /** Boundary responsible for the failure. */
   origin;
+  /** Stable reason family for policy and diagnostics. */
   category;
+  /** Whether repeating the same semantic call is delivery-safe. */
   retryable;
+  /** Provider or Deepline request id, or `null`. */
   requestId;
+  /** Network failure kind, or `null` for non-network failures. */
   networkKind;
+  /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Constructed by the SDK after a structured tool HTTP 429. */
   constructor(message, options) {
     super(options.retryAfterMs ?? 5e3, message);
     this.name = "ToolRateLimitError";
@@ -474,6 +524,7 @@ var ToolRateLimitError = class extends RateLimitError {
   }
 };
 var ConfigError = class extends DeeplineError {
+  /** Construct a local SDK configuration failure. */
   constructor(message) {
     super(message, void 0, "CONFIG_ERROR");
     this.name = "ConfigError";
@@ -971,7 +1022,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.302",
+  version: "0.1.303",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-9mH4i-mJ.mjs';
-export { e as ProviderTransientError } from './tool-execution-error-9mH4i-mJ.mjs';
+import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.mjs';
+export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.mjs';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -3168,28 +3168,6 @@ declare const SDK_VERSION: string;
 /** @deprecated Transitional wire id for pre-major-header SDKs only. */
 declare const SDK_API_CONTRACT: string;
 
-/**
- * Base error class for all Deepline SDK errors.
- *
- * Every error thrown by the SDK extends this class, so you can catch all
- * Deepline-specific errors with a single `catch (e) { if (e instanceof DeeplineError) }`.
- *
- * @example
- * ```typescript
- * import { DeeplineClient, DeeplineError, AuthError } from 'deepline';
- *
- * const client = new DeeplineClient();
- * try {
- *   await client.executeTool('dropleads_search_people', { query: 'cto' });
- * } catch (err) {
- *   if (err instanceof AuthError) {
- *     console.error('Bad API key — run: deepline auth register');
- *   } else if (err instanceof DeeplineError) {
- *     console.error(`API error ${err.statusCode}: ${err.message}`);
- *   }
- * }
- * ```
- */
 /**
  * Thrown when the API rejects the request due to an invalid or missing API key.
  *
@@ -3211,8 +3189,11 @@ declare const SDK_API_CONTRACT: string;
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 090
  */
 declare class AuthError extends DeeplineError {
+    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
     constructor(message?: string);
 }
 /**
@@ -3237,10 +3218,13 @@ declare class AuthError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 100
  */
 declare class RateLimitError extends DeeplineError {
     /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
     retryAfterMs: number;
+    /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
     constructor(retryAfterMs?: number, message?: string);
 }
 /**
@@ -3248,18 +3232,37 @@ declare class RateLimitError extends DeeplineError {
  * structured ToolExecutionError ontology. JavaScript has one prototype chain,
  * so this class extends RateLimitError and carries ToolExecutionError's stable
  * cross-bundle brand.
+ *
+ * This class appears in external SDK calls after HTTP 429 retries are
+ * exhausted. It also satisfies `instanceof ToolExecutionError` and, for a
+ * provider-owned rate limit, `instanceof ProviderTransientError`. Authored
+ * Plays should use `ProviderTransientError`; they do not need this
+ * compatibility class.
+ *
+ * @sdkReference errors 110
  */
 declare class ToolRateLimitError extends RateLimitError {
+    /** Public tool id passed to `tools.execute`. */
     readonly toolId: string;
+    /** Provider responsible for the operation, or `null`. */
     readonly provider: string | null;
+    /** Provider operation name, or `null`. */
     readonly operation: string | null;
+    /** Stable machine-readable failure code when one exists. */
     readonly code: string | undefined;
+    /** Boundary responsible for the failure. */
     readonly origin: ToolExecutionError['origin'];
+    /** Stable reason family for policy and diagnostics. */
     readonly category: ToolExecutionError['category'];
+    /** Whether repeating the same semantic call is delivery-safe. */
     readonly retryable: boolean;
+    /** Provider or Deepline request id, or `null`. */
     readonly requestId: string | null;
+    /** Network failure kind, or `null` for non-network failures. */
     readonly networkKind: ToolExecutionError['networkKind'];
+    /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionError['networkScope'];
+    /** Constructed by the SDK after a structured tool HTTP 429. */
     constructor(message: string, options: ToolExecutionErrorOptions);
 }
 /**
@@ -3280,8 +3283,11 @@ declare class ToolRateLimitError extends RateLimitError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 120
  */
 declare class ConfigError extends DeeplineError {
+    /** Construct a local SDK configuration failure. */
     constructor(message: string);
 }
 
@@ -3672,6 +3678,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             count: number | null;
             keys: Record<string, string>;
         }>;
+        /** Original declarations preserve semantic accessor names across replay. */
+        listExtractorPaths?: readonly string[];
     };
 };
 type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-9mH4i-mJ.js';
-export { e as ProviderTransientError } from './tool-execution-error-9mH4i-mJ.js';
+import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.js';
+export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.js';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
@@ -3168,28 +3168,6 @@ declare const SDK_VERSION: string;
 /** @deprecated Transitional wire id for pre-major-header SDKs only. */
 declare const SDK_API_CONTRACT: string;
 
-/**
- * Base error class for all Deepline SDK errors.
- *
- * Every error thrown by the SDK extends this class, so you can catch all
- * Deepline-specific errors with a single `catch (e) { if (e instanceof DeeplineError) }`.
- *
- * @example
- * ```typescript
- * import { DeeplineClient, DeeplineError, AuthError } from 'deepline';
- *
- * const client = new DeeplineClient();
- * try {
- *   await client.executeTool('dropleads_search_people', { query: 'cto' });
- * } catch (err) {
- *   if (err instanceof AuthError) {
- *     console.error('Bad API key — run: deepline auth register');
- *   } else if (err instanceof DeeplineError) {
- *     console.error(`API error ${err.statusCode}: ${err.message}`);
- *   }
- * }
- * ```
- */
 /**
  * Thrown when the API rejects the request due to an invalid or missing API key.
  *
@@ -3211,8 +3189,11 @@ declare const SDK_API_CONTRACT: string;
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 090
  */
 declare class AuthError extends DeeplineError {
+    /** Constructed by the SDK when Deepline rejects the caller's credentials. */
     constructor(message?: string);
 }
 /**
@@ -3237,10 +3218,13 @@ declare class AuthError extends DeeplineError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 100
  */
 declare class RateLimitError extends DeeplineError {
     /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
     retryAfterMs: number;
+    /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
     constructor(retryAfterMs?: number, message?: string);
 }
 /**
@@ -3248,18 +3232,37 @@ declare class RateLimitError extends DeeplineError {
  * structured ToolExecutionError ontology. JavaScript has one prototype chain,
  * so this class extends RateLimitError and carries ToolExecutionError's stable
  * cross-bundle brand.
+ *
+ * This class appears in external SDK calls after HTTP 429 retries are
+ * exhausted. It also satisfies `instanceof ToolExecutionError` and, for a
+ * provider-owned rate limit, `instanceof ProviderTransientError`. Authored
+ * Plays should use `ProviderTransientError`; they do not need this
+ * compatibility class.
+ *
+ * @sdkReference errors 110
  */
 declare class ToolRateLimitError extends RateLimitError {
+    /** Public tool id passed to `tools.execute`. */
     readonly toolId: string;
+    /** Provider responsible for the operation, or `null`. */
     readonly provider: string | null;
+    /** Provider operation name, or `null`. */
     readonly operation: string | null;
+    /** Stable machine-readable failure code when one exists. */
     readonly code: string | undefined;
+    /** Boundary responsible for the failure. */
     readonly origin: ToolExecutionError['origin'];
+    /** Stable reason family for policy and diagnostics. */
     readonly category: ToolExecutionError['category'];
+    /** Whether repeating the same semantic call is delivery-safe. */
     readonly retryable: boolean;
+    /** Provider or Deepline request id, or `null`. */
     readonly requestId: string | null;
+    /** Network failure kind, or `null` for non-network failures. */
     readonly networkKind: ToolExecutionError['networkKind'];
+    /** Network boundary that failed, or `null` for non-network failures. */
     readonly networkScope: ToolExecutionError['networkScope'];
+    /** Constructed by the SDK after a structured tool HTTP 429. */
     constructor(message: string, options: ToolExecutionErrorOptions);
 }
 /**
@@ -3280,8 +3283,11 @@ declare class ToolRateLimitError extends RateLimitError {
  *   }
  * }
  * ```
+ *
+ * @sdkReference errors 120
  */
 declare class ConfigError extends DeeplineError {
+    /** Construct a local SDK configuration failure. */
     constructor(message: string);
 }
 
@@ -3672,6 +3678,8 @@ type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> =
             count: number | null;
             keys: Record<string, string>;
         }>;
+        /** Original declarations preserve semantic accessor names across replay. */
+        listExtractorPaths?: readonly string[];
     };
 };
 type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>, TLists extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>> = {

package/dist/index.js

@@ -116,33 +116,68 @@ function applyBrand(value, brand) {
   });
 }
 var DeeplineError = class _DeeplineError extends Error {
+  /** HTTP status when the failure crossed an HTTP boundary. */
+  statusCode;
+  /** Stable machine-readable error code when one exists. */
+  code;
+  /** Local diagnostic context; not a portable error contract. */
+  details;
+  /**
+   * Construct a Deepline error.
+   *
+   * SDK and runtime code construct these errors. Application and Play code
+   * normally catches the public subclasses instead.
+   *
+   * @param message Human-readable failure summary.
+   * @param statusCode HTTP status when one exists.
+   * @param code Stable machine-readable code when one exists.
+   * @param details Local diagnostic context; never a portable error contract.
+   */
   constructor(message, statusCode, code, details) {
     super(message);
+    this.name = "DeeplineError";
     this.statusCode = statusCode;
     this.code = code;
     this.details = details;
-    this.name = "DeeplineError";
     applyBrand(this, DEEPLINE_ERROR_BRAND);
   }
-  statusCode;
-  code;
-  details;
   static [Symbol.hasInstance](value) {
     if (this !== _DeeplineError) return nativeInstanceOf(this, value);
     return hasBrand(value, DEEPLINE_ERROR_BRAND);
   }
 };
 var ToolExecutionError = class _ToolExecutionError extends DeeplineError {
+  /** Public tool id passed to `tools.execute`. */
   toolId;
+  /** Provider responsible for the operation, or `null` when unattributed. */
   provider;
+  /** Provider operation name, or `null` when unavailable. */
   operation;
+  /** Boundary responsible for the failure. */
   origin;
+  /** Stable reason family for policy and diagnostics. */
   category;
+  /**
+   * Whether repeating the same semantic call is delivery-safe.
+   *
+   * This does not mean the error may be ignored. Waterfall fallthrough is
+   * represented by `ProviderTransientError`.
+   */
   retryable;
+  /** Provider or Deepline request id, or `null` when unavailable. */
   requestId;
+  /** Suggested same-call retry delay in milliseconds, or `null`. */
   retryAfterMs;
+  /** Network failure kind, or `null` for non-network failures. */
   networkKind;
+  /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /**
+   * Construct a structured tool error.
+   *
+   * Deepline constructs this from the versioned `tool_error` payload.
+   * Application and Play code should catch it rather than create it.
+   */
   constructor(message, options) {
     super(
       message,
@@ -178,7 +213,9 @@ function isProviderTransientFailure(input) {
   return input.origin === "provider" && (input.category === "rate_limit" || input.category === "network" || input.category === "upstream");
 }
 var ProviderTransientError = class _ProviderTransientError extends ToolExecutionError {
+  /** Provider attribution is guaranteed for this subtype. */
   origin = "provider";
+  /** Constructed by Deepline when a provider-owned transient failure arrives. */
   constructor(message, options) {
     super(message, {
       ...options,
@@ -332,6 +369,7 @@ function deserializeToolExecutionFailure(message, value, acceptedSchemaVersion)
 
 // src/errors.ts
 var AuthError = class extends DeeplineError {
+  /** Constructed by the SDK when Deepline rejects the caller's credentials. */
   constructor(message = "Authentication failed. Check your DEEPLINE_API_KEY.") {
     super(message, 401, "AUTH_ERROR");
     this.name = "AuthError";
@@ -340,6 +378,7 @@ var AuthError = class extends DeeplineError {
 var RateLimitError = class extends DeeplineError {
   /** Milliseconds to wait before retrying, from the `Retry-After` response header. Defaults to 5000. */
   retryAfterMs;
+  /** Constructed by the SDK after exhausting HTTP-level rate-limit retries. */
   constructor(retryAfterMs = 5e3, message) {
     super(
       message ?? `Rate limited. Retry after ${retryAfterMs}ms.`,
@@ -351,16 +390,27 @@ var RateLimitError = class extends DeeplineError {
   }
 };
 var ToolRateLimitError = class extends RateLimitError {
+  /** Public tool id passed to `tools.execute`. */
   toolId;
+  /** Provider responsible for the operation, or `null`. */
   provider;
+  /** Provider operation name, or `null`. */
   operation;
+  /** Stable machine-readable failure code when one exists. */
   code;
+  /** Boundary responsible for the failure. */
   origin;
+  /** Stable reason family for policy and diagnostics. */
   category;
+  /** Whether repeating the same semantic call is delivery-safe. */
   retryable;
+  /** Provider or Deepline request id, or `null`. */
   requestId;
+  /** Network failure kind, or `null` for non-network failures. */
   networkKind;
+  /** Network boundary that failed, or `null` for non-network failures. */
   networkScope;
+  /** Constructed by the SDK after a structured tool HTTP 429. */
   constructor(message, options) {
     super(options.retryAfterMs ?? 5e3, message);
     this.name = "ToolRateLimitError";
@@ -383,6 +433,7 @@ var ToolRateLimitError = class extends RateLimitError {
   }
 };
 var ConfigError = class extends DeeplineError {
+  /** Construct a local SDK configuration failure. */
   constructor(message) {
     super(message, void 0, "CONFIG_ERROR");
     this.name = "ConfigError";
@@ -709,7 +760,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.302",
+  version: "0.1.303",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -6154,6 +6205,11 @@ function normalizeTableNamespace(value) {
   );
 }
 
+// ../shared_libs/play-runtime/tool-result-paths.ts
+function listNameFromDeclaredPath(path) {
+  return String(path || "").split(".").filter(Boolean).at(-1)?.replace(/[^A-Za-z0-9_$]/g, "") || null;
+}
+
 // ../shared_libs/play-runtime/tool-result.ts
 var TARGET_FALLBACK_KEYS = {
   email: [/^email$/i, /^address$/i, /email/i],
@@ -6494,38 +6550,33 @@ function coerceToEnum(value, descriptor) {
 function resolveListRows(result, listExtractorPaths) {
   const lists = {};
   for (const rawPath of listExtractorPaths ?? []) {
+    const listName = listNameFromDeclaredPath(rawPath);
+    if (!listName) continue;
     const path = normalizeResultPath(rawPath);
     if (!path) continue;
     const candidates = [...candidateResultPaths(rawPath)].filter(
       (candidate, index, all) => candidate && all.indexOf(candidate) === index
     );
-    let resolvedPath = null;
-    let rows = null;
+    let resolved = null;
     let emptyMatch = null;
     for (const candidate of candidates) {
-      rows = normalizeRows(getAtPath(result, candidate));
-      if (!rows) {
+      const candidateRows = normalizeRows(getAtPath(result, candidate));
+      if (!candidateRows) {
         continue;
       }
-      if (rows.length > 0) {
-        resolvedPath = candidate;
+      if (candidateRows.length > 0) {
+        resolved = { path: candidate, rows: candidateRows };
         break;
       }
-      emptyMatch ??= { path: candidate, rows };
-    }
-    if (!rows && emptyMatch) {
-      resolvedPath = emptyMatch.path;
-      rows = emptyMatch.rows;
+      emptyMatch ??= { path: candidate, rows: candidateRows };
     }
-    if (!rows) continue;
-    const storedPath = resolvedPath ?? path;
-    const name = storedPath.split(".").filter(Boolean).at(-1)?.replace(/\[\d+\]$/, "");
-    const listName = name || storedPath;
+    resolved ??= emptyMatch;
+    if (!resolved) continue;
     const existing = lists[listName];
-    if (existing?.rows.length && rows.length === 0) {
+    if (existing?.rows.length && resolved.rows.length === 0) {
       continue;
     }
-    lists[listName] = { path: storedPath, rows };
+    lists[listName] = resolved;
   }
   return lists;
 }
@@ -6759,6 +6810,7 @@ function createToolExecuteResult(input) {
     toolId: input.metadata.toolId,
     execution: input.execution,
     targets,
+    listExtractorPaths: [...input.metadata.listExtractorPaths ?? []],
     ...input.metadata.extractors ? { extractors: input.metadata.extractors } : {},
     lists
   };
@@ -6800,6 +6852,19 @@ function attachToolResultListDataset(result, input) {
     count: input.count,
     keys: input.keys ?? existing?.keys ?? {}
   };
+  const declaredPaths = result._metadata.listExtractorPaths ?? [];
+  const inputCandidates = new Set(candidateResultPaths(input.path));
+  const equivalentDeclaration = declaredPaths.find(
+    (path) => candidateResultPaths(path).some(
+      (candidate) => inputCandidates.has(candidate)
+    )
+  );
+  result._metadata.listExtractorPaths = equivalentDeclaration ? [...declaredPaths] : [
+    ...declaredPaths.filter(
+      (path) => listNameFromDeclaredPath(path) !== input.name
+    ),
+    input.path
+  ];
   const accessor = {
     path: input.path,
     count: input.count,