swytchcode-runtime 0.1.0 → 0.1.1

package/README.md

@@ -46,8 +46,12 @@ Equivalent to: `swytchcode exec api.report.export --raw` with input on stdin.
 - **`env`** – Extra environment variables (merged with `process.env`).
 - **`output`** – `"json"` (default), `"raw"`, or `"stream"`. Default is JSON (stdout must be valid JSON; parse failure throws). Use `"raw"` to get stdout as a string. `"stream"` is not supported and will throw; use the CLI directly for streaming.
 - **`raw`** – If `true`, same as `output: "raw"`. Kept for backward compatibility.
+- **`dryRun`** – If `true`, pass `--dry-run` to the CLI; the CLI outputs request details (method, url, headers, body) instead of calling the server.
+- **`allowRaw`** – If `true`, pass `--allow-raw` to the CLI; required for executing raw methods (kernel has this disabled by default).
 - **`debug`** – If `true`, log spawn args, cwd, exit status, and stdout/stderr lengths to stderr.
 
+This runtime invokes `swytchcode exec [canonical_id]` with the flags above. For full exec behavior (exit codes, output format, pipeline), see the [Swytchcode kernel documentation](https://github.com/swytchcode/swytchcode).
+
 **Debug logs** are also enabled when `SWYTCHCODE_RUNTIME_DEBUG=1` or `SWYTCHCODE_RUNTIME_DEBUG=true` (no code change):
 
 ```bash

package/dist/exec.js

@@ -36,9 +36,17 @@ function exec(canonicalId, input, options = {}) {
     }
     const raw = outputMode === "raw";
     const args = ["exec", canonicalIdTrimmed, raw ? "--raw" : "--json"];
+    if (options.dryRun === true)
+        args.push("--dry-run");
+    if (options.allowRaw === true)
+        args.push("--allow-raw");
     const cwd = options.cwd ?? process.cwd();
     const hasInput = input !== undefined && input !== null;
     log(debug, "spawn:", `swytchcode ${args.join(" ")}`);
+    if (options.dryRun === true)
+        log(debug, "dry-run:", "enabled");
+    if (options.allowRaw === true)
+        log(debug, "allow-raw:", "enabled");
     log(debug, "cwd:", cwd);
     log(debug, "stdin:", hasInput ? `JSON (${JSON.stringify(input).length} chars)` : "none");
     const result = (0, node_child_process_1.spawnSync)("swytchcode", args, {

package/dist/types.d.ts

@@ -12,6 +12,10 @@ export interface ExecOptions {
     output?: OutputMode;
     /** If true, same as `output: "raw"`. Kept for backward compatibility. */
     raw?: boolean;
+    /** If true, pass `--dry-run` to the CLI; request details are output instead of calling the server. */
+    dryRun?: boolean;
+    /** If true, pass `--allow-raw` to the CLI; required for executing raw methods (disabled by default in kernel). */
+    allowRaw?: boolean;
     /** If true, log spawn/capture details to process.stderr (for debugging). */
     debug?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swytchcode-runtime",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Thin runtime wrapper around the Swytchcode CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",