deepline 0.3.325 → 0.3.327

package/dist/cli/chunk-OVDNJAJN.mjs

@@ -0,0 +1,8 @@
+// src/cli/shell-quote.ts
+function shellQuote(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+
+export {
+  shellQuote
+};

package/dist/cli/{chunk-XIVUB36F.mjs → chunk-QZAP5VOS.mjs}

@@ -10,11 +10,12 @@ import {
 } from "./chunk-CBVIJSHF.mjs";
 import {
   COORDINATOR_INTERNAL_TOKEN_HEADER,
+  CustomerDbQueryOutcomeUnknownError,
   HttpClient,
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-YE3O2UHM.mjs";
+} from "./chunk-CCRQ2VGJ.mjs";
 import {
   PLAY_RUNTIME_BACKENDS,
   RAW_V2_TOOL_RESPONSE_CONTRACT,
@@ -81,6 +82,102 @@ function playInputExampleArgs(schema) {
   return " --input '@<input.json>'";
 }
 
+// src/db/query.ts
+function planCustomerDbQuery(input) {
+  if (typeof input.sql !== "string" || !input.sql.trim())
+    throw new DeeplineError("sql must not be empty.", 400, "INVALID_SQL");
+  if (input.operationKey !== void 0 && typeof input.operationKey !== "string")
+    throw new DeeplineError(
+      "operationKey must be a string containing 1\u2013512 characters.",
+      400,
+      "INVALID_OPERATION_KEY"
+    );
+  const operationKey = input.operationKey;
+  if (operationKey !== void 0 && (!operationKey.trim() || operationKey.length > 512)) {
+    throw new DeeplineError(
+      "operationKey must contain 1\u2013512 characters.",
+      400,
+      "INVALID_OPERATION_KEY"
+    );
+  }
+  if (input.maxRows !== void 0 && (!Number.isSafeInteger(input.maxRows) || input.maxRows < 1 || input.maxRows > 1e3)) {
+    throw new DeeplineError(
+      "maxRows must be a whole number from 1 to 1000.",
+      400,
+      "INVALID_MAX_ROWS"
+    );
+  }
+  return {
+    request: {
+      method: "POST",
+      path: "/api/v2/db/query",
+      body: {
+        sql: input.sql,
+        ...input.maxRows !== void 0 ? { max_rows: input.maxRows } : {},
+        ...operationKey !== void 0 ? { operation_key: operationKey } : {}
+      }
+    },
+    effects: {
+      cloudMutations: "statement_dependent",
+      localWrites: "none",
+      creditSpending: "none",
+      recovery: operationKey === void 0 ? "unkeyed_unknown_outcome" : "original_operation_key"
+    },
+    transport: {
+      maxRetries: 0,
+      urlFailover: "disabled"
+    }
+  };
+}
+async function queryCustomerDatabase(http, input) {
+  const plan = planCustomerDbQuery(input);
+  let result;
+  try {
+    result = await http.post(
+      plan.request.path,
+      plan.request.body,
+      void 0,
+      {
+        maxRetries: plan.transport.maxRetries,
+        exactUrlOnly: plan.transport.urlFailover === "disabled"
+      }
+    );
+  } catch (error) {
+    if (error instanceof DeeplineError && (error.code?.startsWith("NETWORK_") || // Older API readers return PostgreSQL errors as HTTP 400, including
+    // lost connections and explicitly unknown transaction resolution.
+    /^08[A-Z0-9]{3}$/.test(error.code ?? "") || ["57P01", "57P02", "57P03"].includes(error.code ?? "") || error.statusCode === 408 || (error.statusCode ?? 0) >= 500)) {
+      throw new CustomerDbQueryOutcomeUnknownError(
+        error,
+        plan.request.body.operation_key
+      );
+    }
+    throw error;
+  }
+  if (!result || typeof result !== "object" || Array.isArray(result) || typeof result.command !== "string" || !Array.isArray(result.columns) || !Array.isArray(result.rows) || typeof result.truncated !== "boolean" || result.row_count !== null && (!Number.isSafeInteger(result.row_count) || result.row_count < 0) || !Number.isSafeInteger(result.row_count_returned) || result.row_count_returned < 0) {
+    throw new CustomerDbQueryOutcomeUnknownError(
+      new DeeplineError(
+        "The SQL response did not contain a valid result.",
+        200,
+        "CUSTOMER_DB_QUERY_RESPONSE_INVALID"
+      ),
+      plan.request.body.operation_key
+    );
+  }
+  const operation = result.operation;
+  if (input.operationKey !== void 0 && (!operation || operation.operation_key !== input.operationKey || !Number.isSafeInteger(operation.completed_at_ms) || operation.completed_at_ms < 0 || !["executed", "operation_recovery"].includes(operation.source))) {
+    throw new CustomerDbQueryOutcomeUnknownError(
+      new DeeplineError(
+        "The server did not confirm the original atomic SQL operation.",
+        200,
+        "CUSTOMER_DB_OPERATION_ACK_INVALID"
+      ),
+      input.operationKey,
+      { recoveryAvailable: false }
+    );
+  }
+  return { ...result, scope: { kind: "database", mutability: "current" } };
+}
+
 // ../integration-contracts/opensosdata/execution-policy.ts
 var OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS = 12e4;
 var OPENSOSDATA_POLL_INTERVAL_MS = 3e3;
@@ -3115,7 +3212,8 @@ var DeeplineClient = class _DeeplineClient {
       stopAll: ((options2) => this.stopAllRuns(options2))
     };
     this.db = {
-      query: (input) => this.queryDb(input)
+      query: (input) => this.queryDb(input),
+      planQuery: (input) => planCustomerDbQuery(input)
     };
     this.billing = {
       topUp: (options2) => this.topUpBillingBalance(options2),
@@ -3527,17 +3625,7 @@ var DeeplineClient = class _DeeplineClient {
     return this.executeTool(toolId, input, options);
   }
   async queryDb(input) {
-    const result = await this.http.post(
-      "/api/v2/db/query",
-      {
-        sql: input.sql,
-        ...input.maxRows ? { max_rows: input.maxRows } : {}
-      }
-    );
-    return {
-      ...result,
-      scope: { kind: "database", mutability: "current" }
-    };
+    return queryCustomerDatabase(this.http, input);
   }
   /**
    * Run a bounded SQL query against the current mutable customer database.
@@ -3651,7 +3739,7 @@ var DeeplineClient = class _DeeplineClient {
       artifact: input.artifact
     });
     return this.http.post(
-      "/api/v2/plays/artifacts",
+      input.artifactOnly === true ? "/api/v2/plays/artifacts/immutable" : "/api/v2/plays/artifacts",
       {
         ...input,
         compilerManifest
@@ -6384,6 +6472,8 @@ export {
   CSV_HEADER_MATCHING_NOTE,
   iterateCursorPages,
   playInputExampleArgs,
+  planCustomerDbQuery,
+  validateExecutionIdempotencyKey,
   PRODUCT_NOTIFICATION_EVENT_CATALOG,
   resolveLegacySlackNotification,
   RUN_EVENT_SEARCH_KIND_VALUES,

package/dist/cli/{chunk-6VZDSBK6.mjs → chunk-REP2MYBI.mjs}

@@ -2,10 +2,10 @@ import {
   getAuthedHttpClient,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-AQUNQJ5Y.mjs";
+} from "./chunk-F45425TB.mjs";
 import {
   resolveBaseUrlOnly
-} from "./chunk-YE3O2UHM.mjs";
+} from "./chunk-CCRQ2VGJ.mjs";
 
 // src/cli/commands/git.ts
 function shellQuote(value) {

package/dist/cli/{chunk-PWV2M4LW.mjs → chunk-RSEVBSFE.mjs}

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

package/dist/cli/{chunk-OOPSX57I.js → chunk-TAGHNT5P.js}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkQQ2FG5W3js = require('./chunk-QQ2FG5W3.js');
+var _chunkUROXKPNDjs = require('./chunk-UROXKPND.js');
 
 // src/cli/commands/sessions.ts
 
@@ -420,7 +420,7 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = _chunkQQ2FG5W3js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunkUROXKPNDjs.getAuthedHttpClient.call(void 0, );
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
@@ -452,7 +452,7 @@ async function uploadChunkedSessions(sessions, options) {
     environments: sessions.map(() => detectShellContext()),
     ...options.rating ? { rating: options.rating } : {}
   });
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -481,7 +481,7 @@ async function handleSessionsSend(options) {
       filename: _path.basename.call(void 0, filePath),
       ...rating ? { rating } : {}
     });
-    _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+    _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
       {
         ...response2,
         ok: true,
@@ -530,7 +530,7 @@ async function handleSessionsSend(options) {
     environment: detectShellContext(),
     ...rating ? { rating } : {}
   });
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -635,7 +635,7 @@ ${refreshMeta}
 </body>
 </html>`;
   _fs.writeFileSync.call(void 0, outputPath, html, "utf8");
-  _chunkQQ2FG5W3js.printCommandEnvelope.call(void 0, 
+  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       file: outputPath,

package/dist/cli/{chunk-QQ2FG5W3.js → chunk-UROXKPND.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkPVDQ55PSjs = require('./chunk-PVDQ55PS.js');
+var _chunkDM3SHV6Ujs = require('./chunk-DM3SHV6U.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -136,8 +136,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkPVDQ55PSjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkPVDQ55PSjs.HttpClient)(config) };
+  const config = _chunkDM3SHV6Ujs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunkDM3SHV6Ujs.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -477,7 +477,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkPVDQ55PSjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunkDM3SHV6Ujs.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -725,9 +725,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkPVDQ55PSjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunkDM3SHV6Ujs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkPVDQ55PSjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunkDM3SHV6Ujs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {

package/dist/cli/{chunk-7PZFGB7L.mjs → chunk-YIY74KUF.mjs}

@@ -3408,7 +3408,8 @@ async function bundlePlayFile2(filePath, options = {}) {
     exportName: options.exportName,
     adapter: {
       ...createSdkPlayBundlingAdapter(),
-      sourceIdentityRoot
+      sourceIdentityRoot,
+      ...options.cache === false ? { cacheDir: null } : {}
     }
   });
   if (result.success)