deepline 0.3.291 → 0.3.292

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

@@ -200,7 +200,7 @@ export const 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.291',
+  version: '0.3.292',
   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: {

package/dist/cli/index.js

@@ -3515,7 +3515,7 @@ 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.291",
+  version: "0.3.292",
   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
@@ -11520,6 +11520,9 @@ function errorToJsonPayload(error) {
   if (maybeRecord?.details && typeof maybeRecord.details === "object" && !Array.isArray(maybeRecord.details)) {
     details.details = maybeRecord.details;
   }
+  if (maybeRecord?.guidance && typeof maybeRecord.guidance === "object" && !Array.isArray(maybeRecord.guidance)) {
+    details.guidance = maybeRecord.guidance;
+  }
   const providerConcurrency = providerConcurrencyDiagnostic(maybeRecord);
   if (providerConcurrency) {
     details.providerConcurrency = providerConcurrency;
@@ -15088,7 +15091,9 @@ async function handleDbQuery(args) {
         actions: [{ label: "Tool equivalent", command: toolCommand }]
       }
     },
-    { json: jsonOutput || format === "json" }
+    {
+      json: explicitJsonOutput || format === "json" || format !== "table" && jsonOutput
+    }
   );
   return 0;
 }
@@ -15164,8 +15169,9 @@ Examples:
     "after",
     `
   Notes:
-  Requires --sql (inline SQL or @file.sql). Output is a compact table in a terminal and raw JSON with
-  --json or when stdout is piped. The active auth workspace determines scope.
+  Requires --sql (inline SQL or @file.sql). Output defaults to a compact table in a terminal
+  and JSON when stdout is piped. --format table forces a table even in pipes.
+  --json overrides --format for stdout. The active auth workspace determines scope.
   Read permitted schemas with SELECT, EXPLAIN, or read-only WITH.
   Write only to schema-qualified storage tables. For example, use
   CREATE TABLE storage.blocked (...) instead of CREATE TABLE blocked (...).
@@ -52041,9 +52047,13 @@ async function executeTool(args) {
   }).catch((error) => {
     const guidanceLines = toolGuidanceLines(metadata.guidance);
     if (guidanceLines.length > 0) {
-      console.error(
-        [`Guidance for ${parsed.toolId}:`, ...guidanceLines].join("\n")
-      );
+      if (args.includes("--json") && error instanceof Error) {
+        Object.assign(error, { guidance: metadata.guidance });
+      } else {
+        console.error(
+          [`Guidance for ${parsed.toolId}:`, ...guidanceLines].join("\n")
+        );
+      }
     }
     throw error;
   });

package/dist/cli/index.mjs

@@ -3510,7 +3510,7 @@ 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.291",
+  version: "0.3.292",
   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
@@ -11527,6 +11527,9 @@ function errorToJsonPayload(error) {
   if (maybeRecord?.details && typeof maybeRecord.details === "object" && !Array.isArray(maybeRecord.details)) {
     details.details = maybeRecord.details;
   }
+  if (maybeRecord?.guidance && typeof maybeRecord.guidance === "object" && !Array.isArray(maybeRecord.guidance)) {
+    details.guidance = maybeRecord.guidance;
+  }
   const providerConcurrency = providerConcurrencyDiagnostic(maybeRecord);
   if (providerConcurrency) {
     details.providerConcurrency = providerConcurrency;
@@ -15103,7 +15106,9 @@ async function handleDbQuery(args) {
         actions: [{ label: "Tool equivalent", command: toolCommand }]
       }
     },
-    { json: jsonOutput || format === "json" }
+    {
+      json: explicitJsonOutput || format === "json" || format !== "table" && jsonOutput
+    }
   );
   return 0;
 }
@@ -15179,8 +15184,9 @@ Examples:
     "after",
     `
   Notes:
-  Requires --sql (inline SQL or @file.sql). Output is a compact table in a terminal and raw JSON with
-  --json or when stdout is piped. The active auth workspace determines scope.
+  Requires --sql (inline SQL or @file.sql). Output defaults to a compact table in a terminal
+  and JSON when stdout is piped. --format table forces a table even in pipes.
+  --json overrides --format for stdout. The active auth workspace determines scope.
   Read permitted schemas with SELECT, EXPLAIN, or read-only WITH.
   Write only to schema-qualified storage tables. For example, use
   CREATE TABLE storage.blocked (...) instead of CREATE TABLE blocked (...).
@@ -52182,9 +52188,13 @@ async function executeTool(args) {
   }).catch((error) => {
     const guidanceLines = toolGuidanceLines(metadata.guidance);
     if (guidanceLines.length > 0) {
-      console.error(
-        [`Guidance for ${parsed.toolId}:`, ...guidanceLines].join("\n")
-      );
+      if (args.includes("--json") && error instanceof Error) {
+        Object.assign(error, { guidance: metadata.guidance });
+      } else {
+        console.error(
+          [`Guidance for ${parsed.toolId}:`, ...guidanceLines].join("\n")
+        );
+      }
     }
     throw error;
   });

package/dist/index.js

@@ -1328,7 +1328,7 @@ 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.291",
+  version: "0.3.292",
   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

package/dist/index.mjs

@@ -1232,7 +1232,7 @@ 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.291",
+  version: "0.3.292",
   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

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.291";
+    readonly version: "0.3.292";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.291";
+    readonly version: "0.3.292";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ 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.291",
+  version: "0.3.292",
   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

package/dist/release.mjs

@@ -48,7 +48,7 @@ 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.291",
+  version: "0.3.292",
   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

package/package.json

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