deepline 0.1.276 → 0.1.278

package/dist/bundling-sources/sdk/src/release.ts

@@ -155,7 +155,7 @@ export const 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.276',
+  version: '0.1.278',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -1225,6 +1225,16 @@ export class PlayContextImpl {
   private readonly executionScope: RunExecutionScope;
   private logBuffer: string[] = [];
   private checkpoint: PlayCheckpoint;
+  /**
+   * Durable tool receipts are the replay/cache authority for the execution
+   * paths the host supports. Keeping the same completed result in this
+   * checkpoint retained every provider payload for the lifetime of a run and
+   * copied it again while serializing the terminal. Paths without a matching
+   * receipt API keep the legacy checkpoint cache so local/in-process replay
+   * and bulk-only hosts' direct calls still work.
+   */
+  private readonly durableMappedToolResultsBackedByReceipts: boolean;
+  private readonly durableDirectToolResultsBackedByReceipts: boolean;
   private steps: PlayStep[] = [];
   private explicitMapInvocationKeys = new Set<string>();
   /** The map step currently being built — substeps go here instead of top-level. */
@@ -1383,6 +1393,24 @@ export class PlayContextImpl {
   constructor(options: ContextOptions) {
     this.#options = options;
     this.checkpoint = options.checkpoint ?? emptyCheckpoint();
+    this.durableMappedToolResultsBackedByReceipts = Boolean(
+      (options.claimRuntimeStepReceipt || options.claimRuntimeStepReceipts) &&
+        (options.getRuntimeStepReceipt || options.getRuntimeStepReceipts) &&
+        (options.completeRuntimeStepReceipt ||
+          options.completeRuntimeStepReceipts),
+    );
+    this.durableDirectToolResultsBackedByReceipts = Boolean(
+      options.claimRuntimeStepReceipt &&
+        options.getRuntimeStepReceipt &&
+        options.completeRuntimeStepReceipt,
+    );
+    if (this.durableDirectToolResultsBackedByReceipts) {
+      // A resumed durable runner may receive a legacy checkpoint containing
+      // full tool results. Drop that redundant copy immediately and recover
+      // through the receipt store below. Bulk-only receipt contexts retain the
+      // checkpoint because direct tool calls cannot use the bulk claim path.
+      this.checkpoint.completedToolBatches = {};
+    }
     // The governance play id keys durable ctx receipts (durableCtxKey), the
     // cycle guard, and per-parent child-call counters. It must be the STABLE
     // play name — not the per-run workflow id — so receipts written by one
@@ -3077,16 +3105,25 @@ export class PlayContextImpl {
   private getCachedToolResult(
     toolId: string,
     rowCacheKey: string,
+    path: 'mapped' | 'direct' = 'mapped',
   ): ToolBatchResult | undefined {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return undefined;
+    }
     return this.checkpoint.completedToolBatches[toolId]?.[rowCacheKey];
   }
 
   private getCachedToolResultCandidate(
     toolId: string,
     rowCacheKeys: readonly string[],
+    path: 'mapped' | 'direct' = 'mapped',
   ): { cacheKey: string; result: ToolBatchResult } | null {
     for (const rowCacheKey of rowCacheKeys) {
-      const cached = this.getCachedToolResult(toolId, rowCacheKey);
+      const cached = this.getCachedToolResult(toolId, rowCacheKey, path);
       if (cached?.done) {
         return { cacheKey: rowCacheKey, result: cached };
       }
@@ -3098,7 +3135,15 @@ export class PlayContextImpl {
     toolId: string,
     rowCacheKey: string,
     result: unknown | null,
+    path: 'mapped' | 'direct' = 'mapped',
   ): void {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return;
+    }
     if (!this.checkpoint.completedToolBatches[toolId]) {
       this.checkpoint.completedToolBatches[toolId] = {};
     }
@@ -6349,7 +6394,11 @@ export class PlayContextImpl {
           ? null
           : toolCachePolicy.force
             ? null
-            : this.getCachedToolResultCandidate(toolId, checkpointCacheKeys);
+            : this.getCachedToolResultCandidate(
+                toolId,
+                checkpointCacheKeys,
+                'direct',
+              );
         if (cached) {
           this.log(`Calling tool: ${toolId} recovered from checkpoint`);
           return await this.wrapToolExecutionResult({
@@ -6429,13 +6478,7 @@ export class PlayContextImpl {
           }),
         });
         if (cacheableToolResult) {
-          this.checkpoint.completedToolBatches[toolId] = {
-            ...(this.checkpoint.completedToolBatches[toolId] ?? {}),
-            [directCacheKey]: {
-              done: true,
-              result: wrapped,
-            },
-          };
+          this.cacheToolResult(toolId, directCacheKey, wrapped, 'direct');
           this.#options.onBatchComplete?.(this.checkpoint);
         }
         return wrapped;
@@ -7348,23 +7391,27 @@ export class PlayContextImpl {
     const toolSettlements = await Promise.allSettled(
       [...byTool.entries()].map(async ([toolId, requests]) => {
         this.log(`Executing tool batch ${toolId}: ${requests.length} calls`);
-        const liveStepResults = new Map<string, unknown>();
+        const successfulLiveStepCallIds = new Set<string>();
 
         const recordToolStep = (stepRequests: ToolCallRequest[]): void => {
           if (stepRequests.length === 0) return;
           const stepResults: PlayStepRowResult[] = stepRequests.map((req) => {
-            const hasLiveResult = liveStepResults.has(req.callId);
-            const result = hasLiveResult
-              ? liveStepResults.get(req.callId)
-              : this.getCachedToolResult(toolId, req.cacheKey)?.result;
+            const success =
+              successfulLiveStepCallIds.has(req.callId) ||
+              this.getCachedToolResult(toolId, req.cacheKey)?.result != null;
             return {
               rowId: req.rowId,
-              status: result != null ? 'completed' : 'failed',
-              success: result != null,
-              value: result,
-              error: result != null ? null : 'Tool call failed',
+              status: success ? 'completed' : 'failed',
+              success,
+              error: success ? null : 'Tool call failed',
             };
           });
+          // Step traces are lifecycle observability, not a second row/receipt
+          // store. Keep only call ids long enough to record their bounded
+          // status preview.
+          for (const request of stepRequests) {
+            successfulLiveStepCallIds.delete(request.callId);
+          }
           const toolStep = {
             type: 'tool' as const,
             toolId,
@@ -7643,6 +7690,7 @@ export class PlayContextImpl {
             });
             this.cacheToolResult(toolId, request.cacheKey, wrapped);
             for (const waitingRequest of requestsForKey) {
+              successfulLiveStepCallIds.add(waitingRequest.callId);
               const resolver = this.toolCallResolvers.get(
                 waitingRequest.callId,
               );
@@ -7822,7 +7870,9 @@ export class PlayContextImpl {
                   execution?.jobId,
                   execution?.meta,
                 );
-                liveStepResults.set(owner.callId, result);
+                if (result != null) {
+                  successfulLiveStepCallIds.add(owner.callId);
+                }
                 resolveLiveFollowers(owner, result);
                 recordToolStep([owner]);
                 this.#options.onBatchComplete?.(this.checkpoint);
@@ -8110,7 +8160,9 @@ export class PlayContextImpl {
                     index += 1
                   ) {
                     const request = entry.request.memberRequests[index]!;
-                    liveStepResults.set(request.callId, resolvedResults[index]);
+                    if (resolvedResults[index] != null) {
+                      successfulLiveStepCallIds.add(request.callId);
+                    }
                     resolveLiveFollowers(request, resolvedResults[index]);
                   }
                 }
@@ -8150,7 +8202,9 @@ export class PlayContextImpl {
                 for (let index = 0; index < entries.length; index += 1) {
                   const entry = entries[index]!;
                   const result = resolvedResults[index];
-                  liveStepResults.set(entry.request.callId, result);
+                  if (result != null) {
+                    successfulLiveStepCallIds.add(entry.request.callId);
+                  }
                   resolveLiveFollowers(entry.request, result);
                   entry.resolve(result);
                 }

package/dist/cli/index.js

@@ -718,7 +718,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.276",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -27365,43 +27365,6 @@ async function listTools(category, options = {}) {
   }
   return listToolCategories(emitJson, compact);
 }
-async function listProviders(options = {}) {
-  const client2 = new DeeplineClient();
-  const changed = options.changed === true;
-  const emitJson = options.json === true || shouldEmitJson();
-  const providers = await client2.listProviders({ changed });
-  const render = {
-    sections: [
-      {
-        title: changed ? `${providers.length} recently added providers:` : `${providers.length} providers:`,
-        lines: providers.map((provider) => {
-          const release2 = provider.releasedAt ? ` - v${provider.version ?? "unknown"} (${provider.releasedAt})` : "";
-          return `${provider.provider} (${provider.displayName}) - ${provider.toolCount} tools${release2}`;
-        })
-      },
-      {
-        title: "next",
-        lines: [
-          "Run `deepline tools list <category>` to browse provider tools by category."
-        ]
-      }
-    ]
-  };
-  printCommandEnvelope(
-    {
-      providers,
-      count: providers.length,
-      filters: { changed },
-      commandTemplates: {
-        list: "deepline tools providers",
-        changed: "deepline tools providers --changed"
-      },
-      render
-    },
-    { json: emitJson }
-  );
-  return 0;
-}
 async function searchTools(queryInput, options = {}) {
   const query = queryInput?.trim() ?? "";
   const hasStructuredSearch = Boolean(
@@ -27594,7 +27557,6 @@ Concepts:
   through the plays namespace.
 
 Common commands:
-  deepline tools providers --changed --json
   deepline tools search email --json
   deepline tools describe hunter_email_verifier --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
@@ -27604,28 +27566,6 @@ Output:
   Use execute to run a tool.
 `
   );
-  tools.command("providers").description("List discoverable providers and their available tool counts.").addHelpText(
-    "after",
-    `
-Notes:
-  This directory is served by Deepline's provider catalog; it does not require
-  cloning a public plugins repository. Use --changed to show recently added
-  providers with their catalog version and release date.
-
-Examples:
-  deepline tools providers
-  deepline tools providers --changed
-  deepline tools providers --changed --json
-`
-  ).option(
-    "--changed",
-    "Only list recently added providers with release metadata"
-  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
-    process.exitCode = await listProviders({
-      changed: Boolean(options.changed),
-      json: Boolean(options.json)
-    });
-  });
   tools.command("list [category]").description("Browse tool categories, or list every tool in a category.").addHelpText(
     "after",
     `
@@ -28019,7 +27959,9 @@ function printMonitorTypeFilters(tool) {
   }
 }
 function printMonitorTypeStreams(tool) {
-  const streams = arrayField2(tool, "streams", "output_streams").filter(isRecord9);
+  const streams = arrayField2(tool, "streams", "output_streams").filter(
+    isRecord9
+  );
   if (!streams.length) return;
   console.log("");
   console.log("Filter columns (a play's sqlListeners.where, per stream):");
@@ -29058,6 +29000,83 @@ async function executeTool(args) {
   return 0;
 }
 
+// src/cli/commands/providers.ts
+async function listProviders(options = {}) {
+  const client2 = new DeeplineClient();
+  const changed = options.changed === true;
+  const emitJson = options.json === true || shouldEmitJson();
+  const providers = await client2.listProviders({ changed });
+  const render = {
+    sections: [
+      {
+        title: changed ? `${providers.length} recently added providers:` : `${providers.length} providers:`,
+        lines: providers.map((provider) => {
+          const release2 = provider.releasedAt ? ` - v${provider.version ?? "unknown"} (${provider.releasedAt})` : "";
+          return `${provider.provider} (${provider.displayName}) - ${provider.toolCount} tools${release2}`;
+        })
+      },
+      {
+        title: "next",
+        lines: [
+          "Run `deepline tools list <category>` to browse provider tools by category."
+        ]
+      }
+    ]
+  };
+  printCommandEnvelope(
+    {
+      providers,
+      count: providers.length,
+      filters: { changed },
+      commandTemplates: {
+        list: "deepline providers list",
+        changed: "deepline providers list --changed"
+      },
+      render
+    },
+    { json: emitJson }
+  );
+  return 0;
+}
+function registerProviderCommands(program) {
+  const providers = program.command("providers").description("Browse the catalog of provider integrations.").addHelpText(
+    "after",
+    `
+Notes:
+  This directory is served by Deepline's provider catalog; it does not require
+  cloning a public plugins repository. Use --changed to show recently added
+  providers with their catalog version and release date.
+
+Examples:
+  deepline providers list
+  deepline providers list --changed
+  deepline providers list --changed --json
+`
+  );
+  providers.command("list").description("List discoverable providers and their available tool counts.").addHelpText(
+    "after",
+    `
+Notes:
+  The catalog does not require cloning a public plugins repository. Use
+  --changed to show recently added providers with their catalog version and
+  release date.
+
+Examples:
+  deepline providers list
+  deepline providers list --changed
+  deepline providers list --changed --json
+`
+  ).option(
+    "--changed",
+    "Only list recently added providers with release metadata"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+    process.exitCode = await listProviders({
+      changed: Boolean(options.changed),
+      json: Boolean(options.json)
+    });
+  });
+}
+
 // src/cli/commands/workflow.ts
 var import_promises5 = require("fs/promises");
 var import_node_path17 = require("path");
@@ -30960,7 +30979,20 @@ function resolvePathCommands(command) {
 function resolvePathCommand(command) {
   return resolvePathCommands(command)[0] ?? null;
 }
-function resolvePersistentGlobalCommand() {
+function isHomebrewFormulaCommand(path) {
+  let resolvedPath = path;
+  try {
+    resolvedPath = (0, import_node_fs18.realpathSync)(path);
+  } catch {
+    return false;
+  }
+  const parts = resolvedPath.split(/[\\/]+/);
+  const cellarIndex = parts.lastIndexOf("Cellar");
+  return cellarIndex >= 0 && parts[cellarIndex + 1] === "deepline" && parts.slice(cellarIndex + 3).includes("libexec");
+}
+function resolvePersistentGlobalCommand(pathClis) {
+  const homebrewCommand = pathClis.find(isHomebrewFormulaCommand);
+  if (homebrewCommand) return homebrewCommand;
   const prefix = (0, import_node_child_process4.spawnSync)("npm", ["prefix", "-g"], { encoding: "utf8" });
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
@@ -30969,8 +31001,8 @@ function resolvePersistentGlobalCommand() {
   return candidates.find((candidate) => (0, import_node_fs18.existsSync)(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
-  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand();
   const pathClis = input2?.pathClis ?? resolvePathCommands("deepline");
+  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand(pathClis);
   const path = persistentPath ? pathClis.find(
     (candidate) => pathsResolveToSameFile(candidate, persistentPath)
   ) ?? null : null;
@@ -32437,11 +32469,10 @@ function shouldDeferSkillsSyncForCommand() {
   const args = process.argv.slice(2);
   const command = args[0];
   const subcommand = args[1];
-  if (command === "tools" && ["list", "providers", "search", "grep", "describe", "get"].includes(
-    subcommand ?? ""
-  )) {
+  if (command === "tools" && ["list", "search", "grep", "describe", "get"].includes(subcommand ?? "")) {
     return true;
   }
+  if (command === "providers" && subcommand === "list") return true;
   return (command === "play" || command === "plays") && subcommand === "run" && args.includes("--json");
 }
 function isLegacyNoopInvocation() {
@@ -32665,7 +32696,7 @@ Common commands:
   deepline plays describe prebuilt/person-linkedin-to-email --json
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
   deepline secrets check HUBSPOT_TOKEN
-  deepline tools providers --changed --json
+  deepline providers list --changed --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline update
 
@@ -32745,6 +32776,7 @@ Exit codes:
     }
   });
   registerAuthCommands(program);
+  registerProviderCommands(program);
   registerToolsCommands(program);
   registerPlayCommands(program);
   registerSessionsCommands(program);

package/dist/cli/index.mjs

@@ -703,7 +703,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.276",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -27413,43 +27413,6 @@ async function listTools(category, options = {}) {
   }
   return listToolCategories(emitJson, compact);
 }
-async function listProviders(options = {}) {
-  const client2 = new DeeplineClient();
-  const changed = options.changed === true;
-  const emitJson = options.json === true || shouldEmitJson();
-  const providers = await client2.listProviders({ changed });
-  const render = {
-    sections: [
-      {
-        title: changed ? `${providers.length} recently added providers:` : `${providers.length} providers:`,
-        lines: providers.map((provider) => {
-          const release2 = provider.releasedAt ? ` - v${provider.version ?? "unknown"} (${provider.releasedAt})` : "";
-          return `${provider.provider} (${provider.displayName}) - ${provider.toolCount} tools${release2}`;
-        })
-      },
-      {
-        title: "next",
-        lines: [
-          "Run `deepline tools list <category>` to browse provider tools by category."
-        ]
-      }
-    ]
-  };
-  printCommandEnvelope(
-    {
-      providers,
-      count: providers.length,
-      filters: { changed },
-      commandTemplates: {
-        list: "deepline tools providers",
-        changed: "deepline tools providers --changed"
-      },
-      render
-    },
-    { json: emitJson }
-  );
-  return 0;
-}
 async function searchTools(queryInput, options = {}) {
   const query = queryInput?.trim() ?? "";
   const hasStructuredSearch = Boolean(
@@ -27642,7 +27605,6 @@ Concepts:
   through the plays namespace.
 
 Common commands:
-  deepline tools providers --changed --json
   deepline tools search email --json
   deepline tools describe hunter_email_verifier --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
@@ -27652,28 +27614,6 @@ Output:
   Use execute to run a tool.
 `
   );
-  tools.command("providers").description("List discoverable providers and their available tool counts.").addHelpText(
-    "after",
-    `
-Notes:
-  This directory is served by Deepline's provider catalog; it does not require
-  cloning a public plugins repository. Use --changed to show recently added
-  providers with their catalog version and release date.
-
-Examples:
-  deepline tools providers
-  deepline tools providers --changed
-  deepline tools providers --changed --json
-`
-  ).option(
-    "--changed",
-    "Only list recently added providers with release metadata"
-  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
-    process.exitCode = await listProviders({
-      changed: Boolean(options.changed),
-      json: Boolean(options.json)
-    });
-  });
   tools.command("list [category]").description("Browse tool categories, or list every tool in a category.").addHelpText(
     "after",
     `
@@ -28067,7 +28007,9 @@ function printMonitorTypeFilters(tool) {
   }
 }
 function printMonitorTypeStreams(tool) {
-  const streams = arrayField2(tool, "streams", "output_streams").filter(isRecord9);
+  const streams = arrayField2(tool, "streams", "output_streams").filter(
+    isRecord9
+  );
   if (!streams.length) return;
   console.log("");
   console.log("Filter columns (a play's sqlListeners.where, per stream):");
@@ -29106,6 +29048,83 @@ async function executeTool(args) {
   return 0;
 }
 
+// src/cli/commands/providers.ts
+async function listProviders(options = {}) {
+  const client2 = new DeeplineClient();
+  const changed = options.changed === true;
+  const emitJson = options.json === true || shouldEmitJson();
+  const providers = await client2.listProviders({ changed });
+  const render = {
+    sections: [
+      {
+        title: changed ? `${providers.length} recently added providers:` : `${providers.length} providers:`,
+        lines: providers.map((provider) => {
+          const release2 = provider.releasedAt ? ` - v${provider.version ?? "unknown"} (${provider.releasedAt})` : "";
+          return `${provider.provider} (${provider.displayName}) - ${provider.toolCount} tools${release2}`;
+        })
+      },
+      {
+        title: "next",
+        lines: [
+          "Run `deepline tools list <category>` to browse provider tools by category."
+        ]
+      }
+    ]
+  };
+  printCommandEnvelope(
+    {
+      providers,
+      count: providers.length,
+      filters: { changed },
+      commandTemplates: {
+        list: "deepline providers list",
+        changed: "deepline providers list --changed"
+      },
+      render
+    },
+    { json: emitJson }
+  );
+  return 0;
+}
+function registerProviderCommands(program) {
+  const providers = program.command("providers").description("Browse the catalog of provider integrations.").addHelpText(
+    "after",
+    `
+Notes:
+  This directory is served by Deepline's provider catalog; it does not require
+  cloning a public plugins repository. Use --changed to show recently added
+  providers with their catalog version and release date.
+
+Examples:
+  deepline providers list
+  deepline providers list --changed
+  deepline providers list --changed --json
+`
+  );
+  providers.command("list").description("List discoverable providers and their available tool counts.").addHelpText(
+    "after",
+    `
+Notes:
+  The catalog does not require cloning a public plugins repository. Use
+  --changed to show recently added providers with their catalog version and
+  release date.
+
+Examples:
+  deepline providers list
+  deepline providers list --changed
+  deepline providers list --changed --json
+`
+  ).option(
+    "--changed",
+    "Only list recently added providers with release metadata"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+    process.exitCode = await listProviders({
+      changed: Boolean(options.changed),
+      json: Boolean(options.json)
+    });
+  });
+}
+
 // src/cli/commands/workflow.ts
 import { mkdir as mkdir4, readFile as readFile2, writeFile as writeFile4 } from "fs/promises";
 import { dirname as dirname11, join as join13, resolve as resolve12 } from "path";
@@ -31025,7 +31044,20 @@ function resolvePathCommands(command) {
 function resolvePathCommand(command) {
   return resolvePathCommands(command)[0] ?? null;
 }
-function resolvePersistentGlobalCommand() {
+function isHomebrewFormulaCommand(path) {
+  let resolvedPath = path;
+  try {
+    resolvedPath = realpathSync4(path);
+  } catch {
+    return false;
+  }
+  const parts = resolvedPath.split(/[\\/]+/);
+  const cellarIndex = parts.lastIndexOf("Cellar");
+  return cellarIndex >= 0 && parts[cellarIndex + 1] === "deepline" && parts.slice(cellarIndex + 3).includes("libexec");
+}
+function resolvePersistentGlobalCommand(pathClis) {
+  const homebrewCommand = pathClis.find(isHomebrewFormulaCommand);
+  if (homebrewCommand) return homebrewCommand;
   const prefix = spawnSync("npm", ["prefix", "-g"], { encoding: "utf8" });
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
@@ -31034,8 +31066,8 @@ function resolvePersistentGlobalCommand() {
   return candidates.find((candidate) => existsSync13(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
-  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand();
   const pathClis = input2?.pathClis ?? resolvePathCommands("deepline");
+  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand(pathClis);
   const path = persistentPath ? pathClis.find(
     (candidate) => pathsResolveToSameFile(candidate, persistentPath)
   ) ?? null : null;
@@ -32508,11 +32540,10 @@ function shouldDeferSkillsSyncForCommand() {
   const args = process.argv.slice(2);
   const command = args[0];
   const subcommand = args[1];
-  if (command === "tools" && ["list", "providers", "search", "grep", "describe", "get"].includes(
-    subcommand ?? ""
-  )) {
+  if (command === "tools" && ["list", "search", "grep", "describe", "get"].includes(subcommand ?? "")) {
     return true;
   }
+  if (command === "providers" && subcommand === "list") return true;
   return (command === "play" || command === "plays") && subcommand === "run" && args.includes("--json");
 }
 function isLegacyNoopInvocation() {
@@ -32736,7 +32767,7 @@ Common commands:
   deepline plays describe prebuilt/person-linkedin-to-email --json
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
   deepline secrets check HUBSPOT_TOKEN
-  deepline tools providers --changed --json
+  deepline providers list --changed --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline update
 
@@ -32816,6 +32847,7 @@ Exit codes:
     }
   });
   registerAuthCommands(program);
+  registerProviderCommands(program);
   registerToolsCommands(program);
   registerPlayCommands(program);
   registerSessionsCommands(program);

package/dist/index.js

@@ -438,7 +438,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.276",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.mjs

@@ -367,7 +367,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.276",
+  version: "0.1.278",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.276",
+  "version": "0.1.278",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {