Bump version to 0.2.19-fork in package.json. Enhance debugging in InternalClient and SubprocessCLITransport by logging raw JSONL messages written to stdin when debug mode is enabled. This improves traceability of data being sent to subprocesses, aiding in debugging and monitoring of the SDK's behavior.

Author: tobymarsden

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botanicastudios/claude-code-sdk-ts",
-  "version": "0.2.18-fork",
+  "version": "0.2.19-fork",
   "description": "Unofficial TypeScript port of the official Python Claude Code SDK",
   "type": "module",
   "main": "dist/index.cjs",

src/_internal/client.ts

@@ -104,12 +104,18 @@ export class InternalClient {
       }
     };
 
+    const jsonlString = JSON.stringify(jsonlMessage) + '\n';
+    
     this.debugLog(
       'DEBUG: Writing JSONL to stdin:',
       JSON.stringify(jsonlMessage).substring(0, 100) + '...'
     );
 
-    this.transport.writeToStdin(JSON.stringify(jsonlMessage) + '\n');
+    if (this.options.debug) {
+      this.debugLog('DEBUG stdin (raw):', jsonlString);
+    }
+
+    this.transport.writeToStdin(jsonlString);
 
     this.debugLog('DEBUG: Successfully wrote JSONL message to stdin');
   }

src/_internal/transport/subprocess-cli.ts

@@ -102,12 +102,18 @@ export class SubprocessCLITransport {
             }
           };
 
+          const jsonlString = JSON.stringify(jsonlMessage) + '\n';
+          
           this.debugLog(
             'DEBUG: [Transport] Writing JSONL to process stdin:',
             JSON.stringify(jsonlMessage).substring(0, 150) + '...'
           );
 
-          this.process.stdin.write(JSON.stringify(jsonlMessage) + '\n');
+          if (this.options.debug) {
+            this.debugLog('DEBUG stdin (raw):', jsonlString);
+          }
+
+          this.process.stdin.write(jsonlString);
 
           this.debugLog('DEBUG: [Transport] Successfully wrote JSONL to stdin');
         } else {
@@ -116,6 +122,11 @@ export class SubprocessCLITransport {
             'DEBUG: [Transport] Writing raw data to stdin:',
             data.substring(0, 100) + '...'
           );
+          
+          if (this.options.debug) {
+            this.debugLog('DEBUG stdin (raw):', data);
+          }
+          
           this.process.stdin.write(data);
         }
       } catch (error) {
@@ -355,6 +366,20 @@ export class SubprocessCLITransport {
         this.debugLog('DEBUG: Process exited:', { code, signal });
       });
 
+      // Log all stderr output when debug is enabled
+      if (this.process.stderr && this.options.debug) {
+        this.process.stderr.on('data', (chunk: Buffer) => {
+          this.debugLog('DEBUG stderr (raw):', chunk.toString());
+        });
+      }
+
+      // Log all stdout output when debug is enabled
+      if (this.process.stdout && this.options.debug) {
+        this.process.stdout.on('data', (chunk: Buffer) => {
+          this.debugLog('DEBUG stdout (raw):', chunk.toString());
+        });
+      }
+
       // Send prompt via stdin
       if (this.process.stdin) {
         if (this.streamingMode) {
@@ -367,6 +392,8 @@ export class SubprocessCLITransport {
             }
           };
 
+          const initialJsonlString = JSON.stringify(jsonlMessage) + '\n';
+          
           this.debugLog(
             'DEBUG: [Transport] Sending initial JSONL message in streaming mode',
             {
@@ -378,12 +405,22 @@ export class SubprocessCLITransport {
             }
           );
 
-          this.process.stdin.write(JSON.stringify(jsonlMessage) + '\n');
+          if (this.options.debug) {
+            this.debugLog('DEBUG stdin (raw):', initialJsonlString);
+          }
+
+          this.process.stdin.write(initialJsonlString);
           // Keep stdin open for potential streaming input and for keepAlive behavior
           // stdin will be closed when we receive a result message (if keepAlive=false) or explicitly via end()
         } else {
           // For simple queries, send as plain text and close stdin
-          this.process.stdin.write(this.prompt + '\n');
+          const promptString = this.prompt + '\n';
+          
+          if (this.options.debug) {
+            this.debugLog('DEBUG stdin (raw):', promptString);
+          }
+          
+          this.process.stdin.write(promptString);
           this.process.stdin.end();
         }
       }