deepline 0.3.1 → 0.3.2

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

@@ -4656,6 +4656,12 @@ export class DeeplineClient {
       {
         method: 'POST',
         body: definition,
+        // A provider can reject a create with a 429 after Deepline has begun
+        // the lifecycle request. Do not replay a mutation or hide the server's
+        // monitor-specific recovery guidance behind a generic transport retry.
+        maxRetries: 0,
+        exactUrlOnly: true,
+        preserveRateLimitResponse: true,
       },
     );
     if (definition.tool !== 'deepline.analytics') return deployed;

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

@@ -70,6 +70,12 @@ interface RequestOptions {
   maxRetries?: number;
   /** Disable localhost/127.0.0.1 failover for non-idempotent requests. */
   exactUrlOnly?: boolean;
+  /**
+   * Return a server-owned 429 envelope as a DeeplineError instead of replacing
+   * it with the transport's generic RateLimitError. Lifecycle mutations use
+   * this when their response explains whether the upstream change applied.
+   */
+  preserveRateLimitResponse?: boolean;
   /** Enables endpoint-specific structured tool failure mapping. */
   toolId?: string;
 }
@@ -419,6 +425,17 @@ export class HttpClient {
           }
 
           if (response.status === 429) {
+            if (
+              options?.preserveRateLimitResponse &&
+              isMonitorRateLimitEnvelope(parsed)
+            ) {
+              throw new DeeplineError(
+                apiErrorMessage(parsed, response.status),
+                response.status,
+                apiErrorCodeFromResponse(parsed),
+                { response: parsed },
+              );
+            }
             const retryAfter = parseRetryAfter(response);
             lastError = new RateLimitError(retryAfter);
             if (attempt < maxRetries) {
@@ -779,6 +796,21 @@ function isProviderOriginatedHttpError(parsed: unknown): boolean {
   return failureOrigin === 'provider' || code === 'UPSTREAM_BLOCKED';
 }
 
+/**
+ * A monitor deployment may receive a safe, actionable 429 from Deepline after
+ * an upstream lifecycle attempt. Do not treat a CDN/WAF 429 as that envelope:
+ * it can be arbitrary HTML or text and must retain normal RateLimitError
+ * behavior.
+ */
+function isMonitorRateLimitEnvelope(parsed: unknown): boolean {
+  const response = asRecord(parsed);
+  const error = asRecord(response?.error);
+  return (
+    error?.code === 'monitor_upstream_rate_limited' &&
+    typeof error.message === 'string'
+  );
+}
+
 function apiErrorCodeFromResponse(parsed: unknown): string {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);

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

@@ -192,7 +192,7 @@ export const SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: '0.3.1',
+  version: '0.3.2',
   updateSummary:
     'New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.',
   contracts: {

package/dist/cli/index.js

@@ -1047,7 +1047,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.1",
+  version: "0.3.2",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -1466,6 +1466,14 @@ var HttpClient = class {
             throw structuredToolError;
           }
           if (response.status === 429) {
+            if (options?.preserveRateLimitResponse && isMonitorRateLimitEnvelope(parsed)) {
+              throw new DeeplineError(
+                apiErrorMessage(parsed, response.status),
+                response.status,
+                apiErrorCodeFromResponse(parsed),
+                { response: parsed }
+              );
+            }
             const retryAfter = parseRetryAfter(response);
             lastError = new RateLimitError(retryAfter);
             if (attempt < maxRetries) {
@@ -1727,6 +1735,11 @@ function isProviderOriginatedHttpError(parsed) {
   const code = error?.code ?? response?.code;
   return failureOrigin === "provider" || code === "UPSTREAM_BLOCKED";
 }
+function isMonitorRateLimitEnvelope(parsed) {
+  const response = asRecord(parsed);
+  const error = asRecord(response?.error);
+  return error?.code === "monitor_upstream_rate_limited" && typeof error.message === "string";
+}
 function apiErrorCodeFromResponse(parsed) {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);
@@ -6503,7 +6516,13 @@ var DeeplineClient = class {
       "/api/v2/monitors/deploy",
       {
         method: "POST",
-        body: definition
+        body: definition,
+        // A provider can reject a create with a 429 after Deepline has begun
+        // the lifecycle request. Do not replay a mutation or hide the server's
+        // monitor-specific recovery guidance behind a generic transport retry.
+        maxRetries: 0,
+        exactUrlOnly: true,
+        preserveRateLimitResponse: true
       }
     );
     if (definition.tool !== "deepline.analytics") return deployed;

package/dist/cli/index.mjs

@@ -1033,7 +1033,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.1",
+  version: "0.3.2",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -1452,6 +1452,14 @@ var HttpClient = class {
             throw structuredToolError;
           }
           if (response.status === 429) {
+            if (options?.preserveRateLimitResponse && isMonitorRateLimitEnvelope(parsed)) {
+              throw new DeeplineError(
+                apiErrorMessage(parsed, response.status),
+                response.status,
+                apiErrorCodeFromResponse(parsed),
+                { response: parsed }
+              );
+            }
             const retryAfter = parseRetryAfter(response);
             lastError = new RateLimitError(retryAfter);
             if (attempt < maxRetries) {
@@ -1713,6 +1721,11 @@ function isProviderOriginatedHttpError(parsed) {
   const code = error?.code ?? response?.code;
   return failureOrigin === "provider" || code === "UPSTREAM_BLOCKED";
 }
+function isMonitorRateLimitEnvelope(parsed) {
+  const response = asRecord(parsed);
+  const error = asRecord(response?.error);
+  return error?.code === "monitor_upstream_rate_limited" && typeof error.message === "string";
+}
 function apiErrorCodeFromResponse(parsed) {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);
@@ -6489,7 +6502,13 @@ var DeeplineClient = class {
       "/api/v2/monitors/deploy",
       {
         method: "POST",
-        body: definition
+        body: definition,
+        // A provider can reject a create with a 429 after Deepline has begun
+        // the lifecycle request. Do not replay a mutation or hide the server's
+        // monitor-specific recovery guidance behind a generic transport retry.
+        maxRetries: 0,
+        exactUrlOnly: true,
+        preserveRateLimitResponse: true
       }
     );
     if (definition.tool !== "deepline.analytics") return deployed;

package/dist/index.js

@@ -783,7 +783,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.1",
+  version: "0.3.2",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -1202,6 +1202,14 @@ var HttpClient = class {
             throw structuredToolError;
           }
           if (response.status === 429) {
+            if (options?.preserveRateLimitResponse && isMonitorRateLimitEnvelope(parsed)) {
+              throw new DeeplineError(
+                apiErrorMessage(parsed, response.status),
+                response.status,
+                apiErrorCodeFromResponse(parsed),
+                { response: parsed }
+              );
+            }
             const retryAfter = parseRetryAfter(response);
             lastError = new RateLimitError(retryAfter);
             if (attempt < maxRetries) {
@@ -1463,6 +1471,11 @@ function isProviderOriginatedHttpError(parsed) {
   const code = error?.code ?? response?.code;
   return failureOrigin === "provider" || code === "UPSTREAM_BLOCKED";
 }
+function isMonitorRateLimitEnvelope(parsed) {
+  const response = asRecord(parsed);
+  const error = asRecord(response?.error);
+  return error?.code === "monitor_upstream_rate_limited" && typeof error.message === "string";
+}
 function apiErrorCodeFromResponse(parsed) {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);
@@ -6239,7 +6252,13 @@ var DeeplineClient = class {
       "/api/v2/monitors/deploy",
       {
         method: "POST",
-        body: definition
+        body: definition,
+        // A provider can reject a create with a 429 after Deepline has begun
+        // the lifecycle request. Do not replay a mutation or hide the server's
+        // monitor-specific recovery guidance behind a generic transport retry.
+        maxRetries: 0,
+        exactUrlOnly: true,
+        preserveRateLimitResponse: true
       }
     );
     if (definition.tool !== "deepline.analytics") return deployed;

package/dist/index.mjs

@@ -706,7 +706,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.1",
+  version: "0.3.2",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -1125,6 +1125,14 @@ var HttpClient = class {
             throw structuredToolError;
           }
           if (response.status === 429) {
+            if (options?.preserveRateLimitResponse && isMonitorRateLimitEnvelope(parsed)) {
+              throw new DeeplineError(
+                apiErrorMessage(parsed, response.status),
+                response.status,
+                apiErrorCodeFromResponse(parsed),
+                { response: parsed }
+              );
+            }
             const retryAfter = parseRetryAfter(response);
             lastError = new RateLimitError(retryAfter);
             if (attempt < maxRetries) {
@@ -1386,6 +1394,11 @@ function isProviderOriginatedHttpError(parsed) {
   const code = error?.code ?? response?.code;
   return failureOrigin === "provider" || code === "UPSTREAM_BLOCKED";
 }
+function isMonitorRateLimitEnvelope(parsed) {
+  const response = asRecord(parsed);
+  const error = asRecord(response?.error);
+  return error?.code === "monitor_upstream_rate_limited" && typeof error.message === "string";
+}
 function apiErrorCodeFromResponse(parsed) {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);
@@ -6162,7 +6175,13 @@ var DeeplineClient = class {
       "/api/v2/monitors/deploy",
       {
         method: "POST",
-        body: definition
+        body: definition,
+        // A provider can reject a create with a 429 after Deepline has begun
+        // the lifecycle request. Do not replay a mutation or hide the server's
+        // monitor-specific recovery guidance behind a generic transport retry.
+        maxRetries: 0,
+        exactUrlOnly: true,
+        preserveRateLimitResponse: true
       }
     );
     if (definition.tool !== "deepline.analytics") return deployed;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",