deepline 0.3.392 → 0.3.394

package/dist/cli/{chunk-24VEN5PQ.mjs → chunk-5BB2RGAX.mjs}

@@ -13,17 +13,17 @@ import {
   listPlayFileExports,
   parsePlaySourceForAnalysis,
   resolveEnabledExecutionProfile
-} from "./chunk-DSWSEHRX.mjs";
+} from "./chunk-3HWALOL2.mjs";
 import {
   parseCsvDataInput
 } from "./chunk-HQXL5526.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-HGYBEAQP.mjs";
+} from "./chunk-ZYBGA4AR.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-A3APGZFP.mjs";
+} from "./chunk-XRQ2AQL7.mjs";
 import {
   pinLocalPlayImports,
   planLocalPlayExecution
@@ -42,7 +42,7 @@ import {
   normalizeRunEventOperationRequest,
   parseLogLevel,
   playInputExampleArgs
-} from "./chunk-YN6YA7ZZ.mjs";
+} from "./chunk-JHIJIHFB.mjs";
 import {
   CSV_DATA_INPUT_KEY,
   buildNamedPlayRunRequest,
@@ -52,7 +52,7 @@ import {
   setDottedInputValue,
   stageFileInputs,
   stagedFileContentType
-} from "./chunk-Q6EOHNRH.mjs";
+} from "./chunk-JI2B4RZP.mjs";
 import {
   recordCliTrace,
   traceCliSpan
@@ -75,10 +75,10 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-2G7DXFHI.mjs";
+} from "./chunk-NR3DFKNF.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-2GAHHSLB.mjs";
+} from "./chunk-FJGW5GXU.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -5352,7 +5352,7 @@ function stringValue(value) {
 var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline describe <tool>`. Read tool-specific fields from `toolExecutionResult.toolResponse.rawV2` using the nesting shown in the response example, and use `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
 var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy, durable, and async-only. Use `.count()`, `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.length`, numeric indexing, spread, synchronous iteration, `.rows`, or `.toArray()`.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
-var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and result-cache identity; terminal cache reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
+var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and result-cache identity; terminal cache reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy. In authoring edition 11, also choose `staleAfterSeconds`: `0` for fresh logical work, a positive integer for the maximum reusable result age in seconds, or `null` for indefinite result reuse.";
 var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or dataset-backed batch plays must be run directly, exported, then consumed by a separate play.";
 var MAP_BACKED_CHILD_HINT = "Deepline hint: dataset-backed child plays own durable table state and cannot be called from another play. Run that play directly, export its dataset, then pass the CSV to the next play.";
 function sourceLineForError(sourceCode, error) {
@@ -5562,6 +5562,13 @@ function resolveDaytonaSandboxComputeItem(input) {
   };
 }
 
+// ../play-runtime/runtime-constants.ts
+var STANDARD_PLAY_RUNTIME_LIMIT_SECONDS = 30 * 60;
+var PLAY_RUNNER_TERMINAL_GRACE_SECONDS = 90;
+var PLAY_RUNNER_STARTUP_GRACE_SECONDS = 4 * 60;
+var PLAY_RUNNER_TIMEOUT_SECONDS = 40 * 60;
+var WORKFLOW_EXECUTOR_TOKEN_TTL_SECONDS = MAX_PLAY_SANDBOX_RUNTIME_LIMITS.timeoutSeconds + (PLAY_RUNNER_TIMEOUT_SECONDS - STANDARD_PLAY_RUNTIME_LIMIT_SECONDS);
+
 // ../billing/compute-pricing-contract.ts
 var COMPUTE_BILLING_MARKUP_MULTIPLIER = 5;
 var DEFAULT_USD_PER_CUSTOMER_CREDIT = 0.1;
@@ -5570,10 +5577,13 @@ function roundUpCredits(value) {
   if (!Number.isFinite(value) || value <= 0) return 0;
   return Math.ceil(value * 100) / 100;
 }
+function maximumPlaySandboxBillingSeconds(limits) {
+  return limits.timeoutSeconds + PLAY_RUNNER_TERMINAL_GRACE_SECONDS;
+}
 function estimateDaytonaMaximumComputeCredits(limits) {
   const item = resolveDaytonaSandboxComputeItem({
     itemId: "estimate",
-    wallTimeSeconds: limits.timeoutSeconds,
+    wallTimeSeconds: maximumPlaySandboxBillingSeconds(limits),
     cpu: limits.cpu,
     memoryGiB: limits.memoryGiB,
     diskGiB: limits.diskGiB
@@ -7519,6 +7529,8 @@ function parsePlayRunOptions(args, initialInput = null) {
   let playName = null;
   let input = initialInput === null ? null : structuredClone(initialInput);
   let revisionId = null;
+  let workflowId = null;
+  let maxTotalCredits = null;
   let revisionSelector = null;
   const watch = !args.includes("--no-wait");
   const dryRun = args.includes("--dry-run");
@@ -7539,6 +7551,22 @@ function parsePlayRunOptions(args, initialInput = null) {
   let headers = null;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
+    if (arg === "--workflow-id") {
+      const value = args[++index];
+      if (!value || value.startsWith("--"))
+        throw new Error("--workflow-id requires the original caller run ID.");
+      workflowId = value;
+      continue;
+    }
+    if (arg === "--max-total-credits") {
+      const value = args[++index];
+      if (value === void 0 || value.trim() === "" || !Number.isFinite(Number(value)) || Number(value) < 0)
+        throw new Error(
+          "--max-total-credits requires a non-negative number, including zero."
+        );
+      maxTotalCredits = Number(value);
+      continue;
+    }
     if (arg === "--header" || arg.startsWith("--header=")) {
       const raw = arg === "--header" ? args[index + 1] : arg.slice("--header=".length);
       if (raw === void 0 || arg === "--header" && raw.startsWith("--")) {
@@ -7777,6 +7805,8 @@ function parsePlayRunOptions(args, initialInput = null) {
     target: filePath ? { kind: "file", path: filePath } : { kind: "name", name: playName },
     input,
     revisionId,
+    workflowId,
+    maxTotalCredits,
     revisionSelector,
     watch,
     emitLogs,
@@ -7842,6 +7872,11 @@ function resolvePlayRunCliOptions(target, options, inputArgs = []) {
       "--live, --latest, and --revision-id only apply to named plays."
     );
   const dryRun = options.dryRun ?? base.dryRun;
+  const maxTotalCredits = options.maxTotalCredits === void 0 ? base.maxTotalCredits : Number(options.maxTotalCredits);
+  if (maxTotalCredits !== null && (!Number.isFinite(maxTotalCredits) || maxTotalCredits < 0 || options.maxTotalCredits?.trim() === ""))
+    throw new Error(
+      "--max-total-credits requires a non-negative number, including zero."
+    );
   if (dryRun && resolvedTarget.kind !== "file")
     throw new Error("--dry-run currently requires a local Play file.");
   const profile = stringOption(options.profile, "--profile")?.trim() ?? base.profile;
@@ -7910,6 +7945,8 @@ function resolvePlayRunCliOptions(target, options, inputArgs = []) {
     dryRun,
     input: base.input,
     revisionId,
+    workflowId: stringOption(options.workflowId, "--workflow-id") ?? base.workflowId,
+    maxTotalCredits,
     revisionSelector: options.live ? "live" : options.latest ? "latest" : base.revisionSelector,
     profile,
     fixtureBehavior,
@@ -9628,9 +9665,18 @@ async function waitForPlayCompletionByWatch(input) {
   }
 }
 async function startAndWaitForPlayCompletionByStream(input) {
-  for (let attempt = 0; attempt <= PLAY_START_TRANSIENT_RETRY_DELAYS_MS.length; attempt += 1) {
-    const status = await startAndWaitForPlayCompletionByStreamOnce(input);
-    const retryDelayMs = PLAY_START_TRANSIENT_RETRY_DELAYS_MS[attempt];
+  const prepared = await input.client.preparePlayRunAdmission(input.request, {
+    onSubmission: input.onSubmission
+  });
+  const pinnedInput = {
+    ...input,
+    request: prepared.body,
+    startStream: prepared.startStream
+  };
+  const retryDelays = prepared.supportsCallerIntent ? PLAY_START_TRANSIENT_RETRY_DELAYS_MS : [];
+  for (let attempt = 0; attempt <= retryDelays.length; attempt += 1) {
+    const status = await startAndWaitForPlayCompletionByStreamOnce(pinnedInput);
+    const retryDelayMs = retryDelays[attempt];
     if (retryDelayMs === void 0 || !isRetryablePendingStartFailure(status)) {
       return status;
     }
@@ -9715,7 +9761,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input) {
     } : null;
   };
   try {
-    for await (const event of input.client.startPlayRunStream(input.request, {
+    for await (const event of input.startStream({
       signal: controller.signal
     })) {
       eventCount += 1;
@@ -13197,6 +13243,8 @@ async function handleFileBackedRun(options, hooks) {
     ...options.debugMapLatency ? { mapLatencyProfile: true } : {}
   };
   const startRequest = {
+    ...options.workflowId ? { workflowId: options.workflowId } : {},
+    ...options.maxTotalCredits !== null ? { maxTotalCredits: options.maxTotalCredits } : {},
     name: playName,
     sourceCode: bundleResult.sourceCode,
     sourceFiles: bundleResult.sourceFiles,
@@ -13234,6 +13282,7 @@ async function handleFileBackedRun(options, hooks) {
         open: options.open,
         progress,
         onRunStarted: hooks?.onRunStarted,
+        onSubmission: hooks?.onSubmission,
         onRunAdmitted: hooks?.onRunAdmitted
       }).catch(async (error) => {
         throw await normalizePlayStartError(client, error, playName);
@@ -13271,7 +13320,7 @@ async function handleFileBackedRun(options, hooks) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "file", playName },
-    () => client.startPlayRun(startRequest).catch(async (error) => {
+    () => client.startPlayRun(startRequest, { onSubmission: hooks?.onSubmission }).catch(async (error) => {
       throw await normalizePlayStartError(client, error, playName);
     })
   );
@@ -13395,6 +13444,8 @@ async function handleNamedRun(options, hooks) {
     runtimeInput,
     stagedFileInputs,
     extra: {
+      ...options.workflowId ? { workflowId: options.workflowId } : {},
+      ...options.maxTotalCredits !== null ? { maxTotalCredits: options.maxTotalCredits } : {},
       ...options.force ? { force: true } : {},
       ...options.forceToolRefresh ? { forceToolRefresh: true } : {},
       ...options.maxConcurrentExternalCalls !== null ? { maxConcurrentExternalCalls: options.maxConcurrentExternalCalls } : {},
@@ -13423,6 +13474,7 @@ async function handleNamedRun(options, hooks) {
         open: options.open,
         progress,
         onRunStarted: hooks?.onRunStarted,
+        onSubmission: hooks?.onSubmission,
         onRunAdmitted: hooks?.onRunAdmitted
       }).catch(async (error) => {
         throw await normalizePlayStartError(client, error, playName, {
@@ -13463,7 +13515,7 @@ async function handleNamedRun(options, hooks) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "name", playName },
-    () => client.startPlayRun(startRequest).catch(async (error) => {
+    () => client.startPlayRun(startRequest, { onSubmission: hooks?.onSubmission }).catch(async (error) => {
       throw await normalizePlayStartError(client, error, playName, {
         suggestMissingPlay: true
       });
@@ -13499,12 +13551,36 @@ async function handlePlayRun(args, hooks) {
   } : parsedOptions;
   const runHooks = options.runIdFile ? {
     ...hooks,
+    onSubmission: async (intent) => {
+      const destination = `${options.runIdFile}.submission.json`;
+      const tempPath = runIdFileTempPath(destination);
+      try {
+        const handle = await open(tempPath, "wx", 384);
+        try {
+          await handle.writeFile(
+            JSON.stringify({
+              version: 1,
+              admissionState: "submitted_unknown",
+              baseUrl: new DeeplineClient().baseUrl,
+              ...intent
+            })
+          );
+          await handle.sync();
+        } finally {
+          await handle.close();
+        }
+        await link(tempPath, destination);
+      } finally {
+        await removeRunIdTempFile(tempPath);
+      }
+      await hooks?.onSubmission?.(intent);
+    },
     onRunStarted: async (runId) => {
       try {
         await writePlayRunIdFile(options.runIdFile, runId);
       } catch (error) {
         throw new Error(
-          `Run ${runId} was accepted, but its identity could not be persisted to ${options.runIdFile}: ${error instanceof Error ? error.message : String(error)}. Inspect it with 'deepline runs get ${runId} --full'; do not submit a replacement run.`,
+          `Run ${runId} was accepted, but its identity could not be persisted to ${options.runIdFile}: ${error instanceof Error ? error.message : String(error)}. Inspect it with 'deepline runs get ${runId} --full --json'; do not submit a replacement run.`,
           { cause: error }
         );
       }
@@ -16083,6 +16159,11 @@ function registerPlayCommands(program) {
 Concepts:
   Plays are durable cloud workflows.
   Stable ctx.tools.execute({ id, tool, input, staleAfterSeconds: 0 }) requests fresh work.
+  In authoring edition 11, choose freshness explicitly: 0 for fresh logical
+  work, a positive integer for the maximum reusable result age in seconds, or
+  null for indefinite result reuse. A matching completed operation receipt can
+  still recover that operation after resume; older authored editions retain
+  omitted-value behavior.
   Completed calls are replay-safe during recovery of the same run; unfinished calls may execute again.
   A stable id recovers a completed call; repeating plays run starts new work.
   ctx.dataset adds row keys and row progress.
@@ -16136,6 +16217,58 @@ Common commands:
   deepline plays get prebuilt/person-linkedin-to-email
 `
   );
+  play.command("resume-submission <path>").description(
+    "Inspect or explicitly resubmit the same saved admission intent, preserving its run ID and original revision."
+  ).option(
+    "--inspect",
+    "Read the local submission identity only; no API calls or execution"
+  ).option("--json", "Emit the identity or admission response as JSON").action(
+    async (path, options) => {
+      const saved = JSON.parse(
+        await readFileAsync(resolve5(path), "utf8")
+      );
+      const { callerPlayWorkflowIdMatchesRequest } = await import("./run-identity-MRNCEGV2.mjs");
+      if (saved.version !== 1 || typeof saved.workflowId !== "string" || typeof saved.orgId !== "string" || typeof saved.baseUrl !== "string" || !saved.request || saved.request.admissionOrgId !== saved.orgId || saved.request.workflowId !== saved.workflowId || !callerPlayWorkflowIdMatchesRequest(
+        saved.workflowId,
+        saved.request
+      )) {
+        throw new Error(
+          "The submission file does not contain a complete matching immutable admission intent."
+        );
+      }
+      if (options.inspect) {
+        const result2 = {
+          workflowId: saved.workflowId,
+          admissionState: "unknown",
+          next: {
+            inspect: `deepline runs get ${saved.workflowId} --json`,
+            resume: `deepline plays resume-submission ${shellQuote(path)} --json`
+          }
+        };
+        printCommandEnvelope(result2, {
+          json: options.json,
+          text: `Submission ${saved.workflowId}: admission is unknown. ${result2.next.inspect}
+`
+        });
+        return;
+      }
+      const client = new DeeplineClient();
+      if (new URL(saved.baseUrl).origin !== new URL(client.baseUrl).origin) {
+        throw new Error(
+          "The submission belongs to a different API origin. Select its original host before recovery."
+        );
+      }
+      const result = await client.startPlayRun(saved.request);
+      printCommandEnvelope(
+        { ...result },
+        {
+          json: options.json,
+          text: `Admission ${result.workflowId}: ${result.status ?? "observed"}.
+`
+        }
+      );
+    }
+  );
   play.command("check <target>").description("Check a local play file or named/prebuilt play contract.").addHelpText(
     "after",
     `
@@ -16214,6 +16347,11 @@ Idempotent execution:
   Durable tool-call reuse is based on the actual external call identity:
   same play, tool, semantic input, auth scope, provider action version, and
   cache policy.
+  In authoring edition 11, choose freshness explicitly: 0 for fresh logical
+  work, a positive integer for the maximum reusable result age in seconds, or
+  null for indefinite result reuse. A matching completed operation receipt can
+  still recover that operation after resume. Older authored editions keep their
+  existing omitted-value behavior.
 
     await ctx.tools.execute({ id: 'company_lookup', tool, input, staleAfterSeconds: 86400 });
 
@@ -16278,6 +16416,12 @@ Examples:
       "Compatibility alias; run waits by default"
     ).hideHelp()
   ).option("--no-wait", "Start the run and return immediately").option(
+    "--workflow-id <id>",
+    "Reconcile or replay the same immutable request with its original caller run ID"
+  ).option(
+    "--max-total-credits <credits>",
+    "Require a strict total spend ceiling including compute; unbounded work is refused before admission"
+  ).option(
     "--run-id-file <path>",
     "Atomically write the accepted run id to a new JSON file"
   ).addOption(
@@ -16546,7 +16690,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-E3DE3ZK3.mjs");
+      const { describeAnything } = await import("./describe-K4ES5LIL.mjs");
       process.exitCode = await describeAnything(
         name,
         {
@@ -16789,6 +16933,31 @@ Examples:
   registerRunChildrenCommand(runs);
   registerRunHistoryCommand(runs);
   registerRunEventsCommand(runs);
+  runs.command("rows-history <runId>").description(
+    "Read one immutable run-row history page; incomplete historical capture is reported explicitly."
+  ).requiredOption("--play <name>", "Play reference owning this dataset").requiredOption(
+    "--dataset <namespace>",
+    "Recorded table namespace from the run dataset metadata"
+  ).option("--limit <rows>", "History entries per page (1 to 1000)", "200").option("--cursor <cursor>", "Opaque nextCursor from the previous page").option("--json", "Emit rows and coverage metadata as JSON").action(
+    async (runId, options) => {
+      const limit = Number(options.limit);
+      if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1e3)
+        throw new Error("--limit must be an integer from 1 to 1000.");
+      const result = await new DeeplineClient().runs.rowHistory({
+        playName: options.play,
+        runId,
+        tableNamespace: options.dataset,
+        limit,
+        cursor: options.cursor
+      });
+      printCompactJson({
+        ...result,
+        ...result.nextCursor ? {
+          next: `deepline runs rows-history ${shellQuote(runId)} --play ${shellQuote(options.play)} --dataset ${shellQuote(options.dataset)} --limit ${limit} --cursor ${shellQuote(result.nextCursor)} --json`
+        } : {}
+      });
+    }
+  );
   runs.command("status <runId>").description(
     "Legacy scalar-only read. Use runs get for canonical status, progress, logs, and results."
   ).option("--json", "Emit JSON output").action(async (runId, options) => {
@@ -16988,7 +17157,10 @@ Examples:
       ...options.logLevel ? ["--log-level", options.logLevel] : []
     ]);
   });
-  const runLogsCommand = runs.command("logs [runId]").description("Read a run\u2019s logs or search recent events.").addHelpText("after", renderRunLogsHelp()).option("--limit <count>", "Maximum results: logs 200; events 100, max 200").option("--out <path>", "Save the full available text log").option("--failed", "Last 20 lines of a failed run").option("--log-level <level>", "debug (default), info, warn or error").option("--step <id>", "Query structured logs from this authored step").option(
+  const runLogsCommand = runs.command("logs [runId]").description("Read a run\u2019s logs or search recent events.").addHelpText("after", renderRunLogsHelp()).option("--limit <count>", "Maximum results: logs 200; events 100, max 200").option("--out <path>", "Save the full available text log").option(
+    "--failed",
+    "Terminal log tail of an overall failed run; completed runs with failed rows use runs events --kind receipt.failed --payloads"
+  ).option("--log-level <level>", "debug (default), info, warn or error").option("--step <id>", "Query structured logs from this authored step").option(
     "--level <level>",
     "Query structured logs at this severity or above"
   ).option(

package/dist/cli/{chunk-JSLPHFP7.js → chunk-6YAUMG27.js}

@@ -49,10 +49,11 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.392",
+  version: "0.3.394",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
-    updatePreferences: 1
+    updatePreferences: 1,
+    skillsGuidance: 1
   },
   contracts: {
     api: {

package/dist/cli/{chunk-MU6M3URX.mjs → chunk-BP33SIZF.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-ZTACINO5.mjs";
+} from "./chunk-X63FDZJZ.mjs";
 
 // src/cli/npm-script-policy.ts
 import { spawnSync } from "child_process";

package/dist/cli/{chunk-WMS5U6YB.js → chunk-CS6RAIVY.js}

@@ -14,7 +14,7 @@ var _chunkXNYIZMNQjs = require('./chunk-XNYIZMNQ.js');
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
 
 
-var _chunkJSLPHFP7js = require('./chunk-JSLPHFP7.js');
+var _chunk6YAUMG27js = require('./chunk-6YAUMG27.js');
 
 // src/errors.ts
 var CustomerDbQueryOutcomeUnknownError = (_class = class extends _chunk7P5AA3SNjs.DeeplineError {
@@ -744,9 +744,9 @@ function resolveCliCommandContext(inputConfig, requestedScope) {
 }
 
 // src/version.ts
-var SDK_VERSION = _chunkJSLPHFP7js.SDK_RELEASE.version;
-var SDK_API_MAJOR = _chunkJSLPHFP7js.SDK_RELEASE.contracts.api.currentMajor;
-var SDK_API_CONTRACT = _nullishCoalesce(_chunkJSLPHFP7js.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
+var SDK_VERSION = _chunk6YAUMG27js.SDK_RELEASE.version;
+var SDK_API_MAJOR = _chunk6YAUMG27js.SDK_RELEASE.contracts.api.currentMajor;
+var SDK_API_CONTRACT = _nullishCoalesce(_chunk6YAUMG27js.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
 
 // src/agent-runtime.ts
 
@@ -1739,13 +1739,14 @@ var HttpClient = class {
       applyExplicitHeaders(headers, { "Content-Type": "application/json" });
     }
     let lastError = null;
-    for (const candidateUrl of buildCandidateUrls(url)) {
+    const candidateUrls = _optionalChain([options, 'optionalAccess', _209 => _209.exactUrlOnly]) ? [url] : buildCandidateUrls(url);
+    for (const candidateUrl of candidateUrls) {
       try {
         const response = await fetch(candidateUrl, {
           method,
           headers,
-          body: _optionalChain([options, 'optionalAccess', _209 => _209.body]) !== void 0 ? JSON.stringify(options.body) : void 0,
-          signal: _optionalChain([options, 'optionalAccess', _210 => _210.signal])
+          body: _optionalChain([options, 'optionalAccess', _210 => _210.body]) !== void 0 ? JSON.stringify(options.body) : void 0,
+          signal: _optionalChain([options, 'optionalAccess', _211 => _211.signal])
         });
         if (!response.ok) {
           const body = await response.text();
@@ -1786,7 +1787,7 @@ var HttpClient = class {
           throw error;
         }
         const normalized = error instanceof Error ? error : new Error(String(error));
-        if (isAbortLikeError(normalized) && _optionalChain([options, 'optionalAccess', _211 => _211.signal, 'optionalAccess', _212 => _212.aborted])) {
+        if (isAbortLikeError(normalized) && _optionalChain([options, 'optionalAccess', _212 => _212.signal, 'optionalAccess', _213 => _213.aborted])) {
           throw new (0, _chunk7P5AA3SNjs.DeeplineError)(
             `Stream from ${this.config.baseUrl} was aborted by the caller.`,
             void 0,
@@ -1807,7 +1808,7 @@ var HttpClient = class {
     }
     throw new (0, _chunk7P5AA3SNjs.DeeplineError)(
       withCoworkNetworkHint(
-        _optionalChain([lastError, 'optionalAccess', _213 => _213.message]) ? `Unable to stream from ${this.config.baseUrl}. ${lastError.message}` : `Unable to stream from ${this.config.baseUrl}.`
+        _optionalChain([lastError, 'optionalAccess', _214 => _214.message]) ? `Unable to stream from ${this.config.baseUrl}. ${lastError.message}` : `Unable to stream from ${this.config.baseUrl}.`
       )
     );
   }
@@ -1869,15 +1870,15 @@ function parseResponseBody(body) {
 }
 function isProviderOriginatedHttpError(parsed) {
   const response = asRecord(parsed);
-  const error = asRecord(_optionalChain([response, 'optionalAccess', _214 => _214.error]));
-  const failureOrigin = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _215 => _215.failure_origin]), () => ( _optionalChain([response, 'optionalAccess', _216 => _216.failure_origin])));
-  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _217 => _217.code]), () => ( _optionalChain([response, 'optionalAccess', _218 => _218.code])));
+  const error = asRecord(_optionalChain([response, 'optionalAccess', _215 => _215.error]));
+  const failureOrigin = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _216 => _216.failure_origin]), () => ( _optionalChain([response, 'optionalAccess', _217 => _217.failure_origin])));
+  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _218 => _218.code]), () => ( _optionalChain([response, 'optionalAccess', _219 => _219.code])));
   return failureOrigin === "provider" || code === "UPSTREAM_BLOCKED";
 }
 function isMonitorRateLimitEnvelope(parsed) {
   const response = asRecord(parsed);
-  const error = asRecord(_optionalChain([response, 'optionalAccess', _219 => _219.error]));
-  return _optionalChain([error, 'optionalAccess', _220 => _220.code]) === "monitor_upstream_rate_limited" && typeof error.message === "string";
+  const error = asRecord(_optionalChain([response, 'optionalAccess', _220 => _220.error]));
+  return _optionalChain([error, 'optionalAccess', _221 => _221.code]) === "monitor_upstream_rate_limited" && typeof error.message === "string";
 }
 function asRecord(value) {
   return typeof value === "object" && value !== null ? value : null;
@@ -1893,7 +1894,7 @@ function detectHtmlErrorBody(body, contentType) {
     return null;
   }
   const titleMatch = trimmed.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
-  const title = _optionalChain([titleMatch, 'optionalAccess', _221 => _221[1], 'optionalAccess', _222 => _222.replace, 'call', _223 => _223(/\s+/g, " "), 'access', _224 => _224.trim, 'call', _225 => _225()]) || void 0;
+  const title = _optionalChain([titleMatch, 'optionalAccess', _222 => _222[1], 'optionalAccess', _223 => _223.replace, 'call', _224 => _224(/\s+/g, " "), 'access', _225 => _225.trim, 'call', _226 => _226()]) || void 0;
   const workerThrewException = /worker threw exception/i.test(trimmed);
   return {
     title,
@@ -1977,20 +1978,20 @@ function decodeSseFrame(frame) {
 }
 function sleep(ms, signal) {
   return new Promise((resolve2, reject) => {
-    if (_optionalChain([signal, 'optionalAccess', _226 => _226.aborted])) {
+    if (_optionalChain([signal, 'optionalAccess', _227 => _227.aborted])) {
       reject(requestCancelledError(signal));
       return;
     }
     const timeoutId = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _227 => _227.removeEventListener, 'call', _228 => _228("abort", abort)]);
+      _optionalChain([signal, 'optionalAccess', _228 => _228.removeEventListener, 'call', _229 => _229("abort", abort)]);
       resolve2();
     }, ms);
     const abort = () => {
       clearTimeout(timeoutId);
-      _optionalChain([signal, 'optionalAccess', _229 => _229.removeEventListener, 'call', _230 => _230("abort", abort)]);
+      _optionalChain([signal, 'optionalAccess', _230 => _230.removeEventListener, 'call', _231 => _231("abort", abort)]);
       reject(requestCancelledError(signal));
     };
-    _optionalChain([signal, 'optionalAccess', _231 => _231.addEventListener, 'call', _232 => _232("abort", abort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _232 => _232.addEventListener, 'call', _233 => _233("abort", abort, { once: true })]);
   });
 }
 function withCoworkNetworkHint(message) {