@opengsd/gsd-pi 1.8.1 → 1.9.0-dev.97ef11e3

package/packages/gsd-cloud/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { handleCloudCommand, formatUsage } from "./cli.js";
+export { injectDefaultGateway, DEFAULT_GATEWAY } from "./inject-gateway.js";
+export { CloudRuntime } from "./cloud-runtime.js";
+export { runDeviceFlow } from "./device-flow.js";
+export { selectExecutor, GsdPiExecutor, type Executor, type AdvertisedProject, type ExecutorKind, type SelectExecutorOptions, } from "./executors/index.js";
+export type { DaemonConfig, LogLevel, LogEntry } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/gsd-cloud/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/packages/gsd-cloud/dist/index.js

@@ -0,0 +1,8 @@
+// Project/App: Open GSD
+// File Purpose: Public entry for @opengsd/gsd-cloud — the standalone cloud agent.
+export { handleCloudCommand, formatUsage } from "./cli.js";
+export { injectDefaultGateway, DEFAULT_GATEWAY } from "./inject-gateway.js";
+export { CloudRuntime } from "./cloud-runtime.js";
+export { runDeviceFlow } from "./device-flow.js";
+export { selectExecutor, GsdPiExecutor, } from "./executors/index.js";
+//# sourceMappingURL=index.js.map

package/packages/gsd-cloud/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,kFAAkF;AAElF,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,aAAa,GAKd,MAAM,sBAAsB,CAAC","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Public entry for @opengsd/gsd-cloud — the standalone cloud agent.\n\nexport { handleCloudCommand, formatUsage } from \"./cli.js\";\nexport { injectDefaultGateway, DEFAULT_GATEWAY } from \"./inject-gateway.js\";\nexport { CloudRuntime } from \"./cloud-runtime.js\";\nexport { runDeviceFlow } from \"./device-flow.js\";\nexport {\n  selectExecutor,\n  GsdPiExecutor,\n  type Executor,\n  type AdvertisedProject,\n  type ExecutorKind,\n  type SelectExecutorOptions,\n} from \"./executors/index.js\";\nexport type { DaemonConfig, LogLevel, LogEntry } from \"./types.js\";\n"]}

package/packages/gsd-cloud/dist/inject-gateway.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The public GSD Cloud gateway. This default lives ONLY in @opengsd/gsd-cloud
+ * (D-01): the SaaS-branded wrapper is the one place the cloud.opengsd.net URL is
+ * intended to appear. The generic @opengsd/daemon requires --gateway explicitly.
+ */
+export declare const DEFAULT_GATEWAY = "https://cloud.opengsd.net";
+/**
+ * Insert `--gateway https://cloud.opengsd.net` for the `login` and `pair`
+ * commands when the caller has not supplied their own `--gateway`. Any other
+ * command (status/connect/disconnect) is returned unchanged, as is an explicit
+ * `--gateway` (the caller-supplied flag always wins) and empty argv.
+ *
+ * Pure function — no process.argv side effects — so the contract is unit-testable.
+ */
+export declare function injectDefaultGateway(argv: string[]): string[];
+//# sourceMappingURL=inject-gateway.d.ts.map

package/packages/gsd-cloud/dist/inject-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-gateway.d.ts","sourceRoot":"","sources":["../src/inject-gateway.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAW7D"}

package/packages/gsd-cloud/dist/inject-gateway.js

@@ -0,0 +1,29 @@
+// Project/App: Open GSD
+// File Purpose: Default the cloud gateway for login/pair when the caller omits --gateway.
+/**
+ * The public GSD Cloud gateway. This default lives ONLY in @opengsd/gsd-cloud
+ * (D-01): the SaaS-branded wrapper is the one place the cloud.opengsd.net URL is
+ * intended to appear. The generic @opengsd/daemon requires --gateway explicitly.
+ */
+export const DEFAULT_GATEWAY = "https://cloud.opengsd.net";
+/**
+ * Insert `--gateway https://cloud.opengsd.net` for the `login` and `pair`
+ * commands when the caller has not supplied their own `--gateway`. Any other
+ * command (status/connect/disconnect) is returned unchanged, as is an explicit
+ * `--gateway` (the caller-supplied flag always wins) and empty argv.
+ *
+ * Pure function — no process.argv side effects — so the contract is unit-testable.
+ */
+export function injectDefaultGateway(argv) {
+    const command = argv[0];
+    const gatewayAwareCommand = command === "login" || command === "pair";
+    // Respect both flag forms `parseArgs` accepts: `--gateway <url>` and
+    // `--gateway=<url>`. Matching only the bare token let an explicit
+    // `--gateway=<url>` slip through and get overridden by the appended default.
+    const hasGateway = argv.some((arg) => arg === "--gateway" || arg.startsWith("--gateway="));
+    if (!gatewayAwareCommand || hasGateway) {
+        return argv;
+    }
+    return [...argv, "--gateway", DEFAULT_GATEWAY];
+}
+//# sourceMappingURL=inject-gateway.js.map

package/packages/gsd-cloud/dist/inject-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-gateway.js","sourceRoot":"","sources":["../src/inject-gateway.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,0FAA0F;AAE1F;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAc;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,mBAAmB,GAAG,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,MAAM,CAAC;IACtE,qEAAqE;IACrE,kEAAkE;IAClE,6EAA6E;IAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3F,IAAI,CAAC,mBAAmB,IAAI,UAAU,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Default the cloud gateway for login/pair when the caller omits --gateway.\n\n/**\n * The public GSD Cloud gateway. This default lives ONLY in @opengsd/gsd-cloud\n * (D-01): the SaaS-branded wrapper is the one place the cloud.opengsd.net URL is\n * intended to appear. The generic @opengsd/daemon requires --gateway explicitly.\n */\nexport const DEFAULT_GATEWAY = \"https://cloud.opengsd.net\";\n\n/**\n * Insert `--gateway https://cloud.opengsd.net` for the `login` and `pair`\n * commands when the caller has not supplied their own `--gateway`. Any other\n * command (status/connect/disconnect) is returned unchanged, as is an explicit\n * `--gateway` (the caller-supplied flag always wins) and empty argv.\n *\n * Pure function — no process.argv side effects — so the contract is unit-testable.\n */\nexport function injectDefaultGateway(argv: string[]): string[] {\n  const command = argv[0];\n  const gatewayAwareCommand = command === \"login\" || command === \"pair\";\n  // Respect both flag forms `parseArgs` accepts: `--gateway <url>` and\n  // `--gateway=<url>`. Matching only the bare token let an explicit\n  // `--gateway=<url>` slip through and get overridden by the appended default.\n  const hasGateway = argv.some((arg) => arg === \"--gateway\" || arg.startsWith(\"--gateway=\"));\n  if (!gatewayAwareCommand || hasGateway) {\n    return argv;\n  }\n  return [...argv, \"--gateway\", DEFAULT_GATEWAY];\n}\n"]}

package/packages/gsd-cloud/dist/inject-gateway.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inject-gateway.test.d.ts.map

package/packages/gsd-cloud/dist/inject-gateway.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-gateway.test.d.ts","sourceRoot":"","sources":["../src/inject-gateway.test.ts"],"names":[],"mappings":""}

package/packages/gsd-cloud/dist/inject-gateway.test.js

@@ -0,0 +1,41 @@
+// Project/App: Open GSD
+// File Purpose: Unit tests locking the default-gateway injection contract.
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { injectDefaultGateway, DEFAULT_GATEWAY } from "./inject-gateway.js";
+test("Test 1: login without --gateway injects the default gateway", () => {
+    const out = injectDefaultGateway(["login"]);
+    assert.ok(out.includes("--gateway"), "expected --gateway flag");
+    assert.ok(out.includes(DEFAULT_GATEWAY), "expected default gateway value");
+    assert.equal(DEFAULT_GATEWAY, "https://cloud.opengsd.net");
+    const idx = out.indexOf("--gateway");
+    assert.equal(out[idx + 1], DEFAULT_GATEWAY, "value must follow the flag");
+});
+test("Test 2: login with explicit --gateway is returned unchanged", () => {
+    const argv = ["login", "--gateway", "https://other.example"];
+    const out = injectDefaultGateway(argv);
+    assert.deepEqual(out, argv);
+    assert.equal(out.filter((a) => a === "--gateway").length, 1, "no double gateway");
+});
+test("Test 3: pair without --gateway injects the default gateway", () => {
+    const out = injectDefaultGateway(["pair", "--code", "X"]);
+    assert.ok(out.includes("--gateway"), "expected --gateway flag");
+    assert.ok(out.includes(DEFAULT_GATEWAY), "expected default gateway value");
+});
+test("Test 4: status/connect/disconnect are returned unchanged", () => {
+    for (const cmd of ["status", "connect", "disconnect"]) {
+        const out = injectDefaultGateway([cmd]);
+        assert.deepEqual(out, [cmd], `${cmd} must not inject a gateway`);
+    }
+});
+test("Test 5: empty argv (no command) is returned unchanged", () => {
+    assert.deepEqual(injectDefaultGateway([]), []);
+});
+test("Test 6: login with equals-form --gateway=... is returned unchanged", () => {
+    const argv = ["login", "--gateway=https://other.example"];
+    const out = injectDefaultGateway(argv);
+    assert.deepEqual(out, argv);
+    assert.ok(!out.includes(DEFAULT_GATEWAY), "default gateway must not be appended");
+    assert.equal(out.filter((a) => a === "--gateway" || a.startsWith("--gateway=")).length, 1, "no double gateway");
+});
+//# sourceMappingURL=inject-gateway.test.js.map

package/packages/gsd-cloud/dist/inject-gateway.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-gateway.test.js","sourceRoot":"","sources":["../src/inject-gateway.test.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Unit tests locking the default-gateway injection contract.\nimport { test } from \"node:test\";\nimport assert from \"node:assert/strict\";\nimport { injectDefaultGateway, DEFAULT_GATEWAY } from \"./inject-gateway.js\";\n\ntest(\"Test 1: login without --gateway injects the default gateway\", () => {\n  const out = injectDefaultGateway([\"login\"]);\n  assert.ok(out.includes(\"--gateway\"), \"expected --gateway flag\");\n  assert.ok(out.includes(DEFAULT_GATEWAY), \"expected default gateway value\");\n  assert.equal(DEFAULT_GATEWAY, \"https://cloud.opengsd.net\");\n  const idx = out.indexOf(\"--gateway\");\n  assert.equal(out[idx + 1], DEFAULT_GATEWAY, \"value must follow the flag\");\n});\n\ntest(\"Test 2: login with explicit --gateway is returned unchanged\", () => {\n  const argv = [\"login\", \"--gateway\", \"https://other.example\"];\n  const out = injectDefaultGateway(argv);\n  assert.deepEqual(out, argv);\n  assert.equal(out.filter((a) => a === \"--gateway\").length, 1, \"no double gateway\");\n});\n\ntest(\"Test 3: pair without --gateway injects the default gateway\", () => {\n  const out = injectDefaultGateway([\"pair\", \"--code\", \"X\"]);\n  assert.ok(out.includes(\"--gateway\"), \"expected --gateway flag\");\n  assert.ok(out.includes(DEFAULT_GATEWAY), \"expected default gateway value\");\n});\n\ntest(\"Test 4: status/connect/disconnect are returned unchanged\", () => {\n  for (const cmd of [\"status\", \"connect\", \"disconnect\"]) {\n    const out = injectDefaultGateway([cmd]);\n    assert.deepEqual(out, [cmd], `${cmd} must not inject a gateway`);\n  }\n});\n\ntest(\"Test 5: empty argv (no command) is returned unchanged\", () => {\n  assert.deepEqual(injectDefaultGateway([]), []);\n});\n\ntest(\"Test 6: login with equals-form --gateway=... is returned unchanged\", () => {\n  const argv = [\"login\", \"--gateway=https://other.example\"];\n  const out = injectDefaultGateway(argv);\n  assert.deepEqual(out, argv);\n  assert.ok(!out.includes(DEFAULT_GATEWAY), \"default gateway must not be appended\");\n  assert.equal(\n    out.filter((a) => a === \"--gateway\" || a.startsWith(\"--gateway=\")).length,\n    1,\n    \"no double gateway\",\n  );\n});\n"]}

package/packages/gsd-cloud/dist/logger.d.ts

@@ -0,0 +1,25 @@
+import type { LogLevel } from './types.js';
+export interface LoggerOptions {
+    filePath: string;
+    level: LogLevel;
+    verbose?: boolean;
+}
+/**
+ * Structured JSON-lines file logger.
+ * Writes LogEntry objects one per line in append mode.
+ * The open write stream keeps the Node event loop alive (daemon keepalive).
+ */
+export declare class Logger {
+    private readonly stream;
+    private readonly level;
+    private readonly verbose;
+    constructor(opts: LoggerOptions);
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+    /** End the write stream. Resolves when the stream is fully flushed. */
+    close(): Promise<void>;
+    private write;
+}
+//# sourceMappingURL=logger.d.ts.map

package/packages/gsd-cloud/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AASrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,IAAI,EAAE,aAAa;IAe/B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIxD,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,OAAO,CAAC,KAAK;CAmBd"}

package/packages/gsd-cloud/dist/logger.js

@@ -0,0 +1,72 @@
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Structured JSON-lines file logger.
+ * Writes LogEntry objects one per line in append mode.
+ * The open write stream keeps the Node event loop alive (daemon keepalive).
+ */
+export class Logger {
+    stream;
+    level;
+    verbose;
+    constructor(opts) {
+        // Ensure parent directory exists
+        const dir = dirname(opts.filePath);
+        try {
+            mkdirSync(dir, { recursive: true });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Cannot create log directory ${dir}: ${msg}`);
+        }
+        this.stream = createWriteStream(opts.filePath, { flags: 'a' });
+        this.level = LEVEL_ORDER[opts.level] ?? LEVEL_ORDER.info;
+        this.verbose = opts.verbose ?? false;
+    }
+    debug(msg, data) {
+        this.write('debug', msg, data);
+    }
+    info(msg, data) {
+        this.write('info', msg, data);
+    }
+    warn(msg, data) {
+        this.write('warn', msg, data);
+    }
+    error(msg, data) {
+        this.write('error', msg, data);
+    }
+    /** End the write stream. Resolves when the stream is fully flushed. */
+    close() {
+        return new Promise((resolve, reject) => {
+            // Attach listeners BEFORE triggering end() so a synchronous error
+            // from end() or an immediate 'close' cannot slip past the listener.
+            this.stream.once('close', () => resolve());
+            this.stream.once('error', reject);
+            this.stream.end();
+        });
+    }
+    write(level, msg, data) {
+        if (LEVEL_ORDER[level] < this.level)
+            return;
+        const entry = {
+            ts: new Date().toISOString(),
+            level,
+            msg,
+            ...(data !== undefined ? { data } : {}),
+        };
+        const line = JSON.stringify(entry) + '\n';
+        this.stream.write(line);
+        if (this.verbose) {
+            const prefix = `[${entry.ts}] ${level.toUpperCase()}`;
+            const suffix = data ? ` ${JSON.stringify(data)}` : '';
+            process.stderr.write(`${prefix}: ${msg}${suffix}\n`);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/packages/gsd-cloud/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { createWriteStream, mkdirSync, type WriteStream } from 'node:fs';\nimport { dirname } from 'node:path';\nimport type { LogLevel, LogEntry } from './types.js';\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nexport interface LoggerOptions {\n  filePath: string;\n  level: LogLevel;\n  verbose?: boolean;\n}\n\n/**\n * Structured JSON-lines file logger.\n * Writes LogEntry objects one per line in append mode.\n * The open write stream keeps the Node event loop alive (daemon keepalive).\n */\nexport class Logger {\n  private readonly stream: WriteStream;\n  private readonly level: number;\n  private readonly verbose: boolean;\n\n  constructor(opts: LoggerOptions) {\n    // Ensure parent directory exists\n    const dir = dirname(opts.filePath);\n    try {\n      mkdirSync(dir, { recursive: true });\n    } catch (err: unknown) {\n      const msg = err instanceof Error ? err.message : String(err);\n      throw new Error(`Cannot create log directory ${dir}: ${msg}`);\n    }\n\n    this.stream = createWriteStream(opts.filePath, { flags: 'a' });\n    this.level = LEVEL_ORDER[opts.level] ?? LEVEL_ORDER.info;\n    this.verbose = opts.verbose ?? false;\n  }\n\n  debug(msg: string, data?: Record<string, unknown>): void {\n    this.write('debug', msg, data);\n  }\n\n  info(msg: string, data?: Record<string, unknown>): void {\n    this.write('info', msg, data);\n  }\n\n  warn(msg: string, data?: Record<string, unknown>): void {\n    this.write('warn', msg, data);\n  }\n\n  error(msg: string, data?: Record<string, unknown>): void {\n    this.write('error', msg, data);\n  }\n\n  /** End the write stream. Resolves when the stream is fully flushed. */\n  close(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      // Attach listeners BEFORE triggering end() so a synchronous error\n      // from end() or an immediate 'close' cannot slip past the listener.\n      this.stream.once('close', () => resolve());\n      this.stream.once('error', reject);\n      this.stream.end();\n    });\n  }\n\n  private write(level: LogLevel, msg: string, data?: Record<string, unknown>): void {\n    if (LEVEL_ORDER[level] < this.level) return;\n\n    const entry: LogEntry = {\n      ts: new Date().toISOString(),\n      level,\n      msg,\n      ...(data !== undefined ? { data } : {}),\n    };\n\n    const line = JSON.stringify(entry) + '\\n';\n    this.stream.write(line);\n\n    if (this.verbose) {\n      const prefix = `[${entry.ts}] ${level.toUpperCase()}`;\n      const suffix = data ? ` ${JSON.stringify(data)}` : '';\n      process.stderr.write(`${prefix}: ${msg}${suffix}\\n`);\n    }\n  }\n}\n"]}

package/packages/gsd-cloud/dist/runtime-process.d.ts

@@ -0,0 +1,27 @@
+export interface RuntimeProcessStatus {
+    running: boolean;
+    pid: number | null;
+    projects: string[];
+    log_file: string;
+}
+interface StartRuntimeOptions {
+    binaryPath: string;
+    configPath: string;
+    projectDirs: string[];
+    readyTimeoutMs?: number;
+    verbose?: boolean;
+}
+export declare const BACKGROUND_RUNTIME_READY_TIMEOUT_MS: number;
+export declare function startBackgroundRuntime(opts: StartRuntimeOptions): Promise<RuntimeProcessStatus>;
+/**
+ * Record a running runtime so a later launch can find and stop it. Used both by
+ * the detached launcher (child PID) and by a `--foreground` session (its own
+ * PID), so the two modes share one source of truth and never coexist on the
+ * same device token.
+ */
+export declare function writeRuntimeState(configPath: string, pid: number, projects: string[]): void;
+export declare function clearRuntimeState(configPath: string): void;
+export declare function stopBackgroundRuntime(configPath: string): Promise<boolean>;
+export declare function backgroundRuntimeStatus(configPath: string): RuntimeProcessStatus;
+export {};
+//# sourceMappingURL=runtime-process.d.ts.map

package/packages/gsd-cloud/dist/runtime-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-process.d.ts","sourceRoot":"","sources":["../src/runtime-process.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD,eAAO,MAAM,mCAAmC,QACoB,CAAC;AAErE,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoDrG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAI3F;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAoBhF"}

package/packages/gsd-cloud/dist/runtime-process.js

@@ -0,0 +1,272 @@
+// Project/App: Open GSD
+// File Purpose: Detached cloud runtime process lifecycle and status persistence.
+import { spawn } from "node:child_process";
+import { chmodSync, closeSync, mkdirSync, openSync, readFileSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS } from "./cloud-runtime.js";
+const PROCESS_STARTUP_GRACE_MS = 5_000;
+const FORCED_STOP_TIMEOUT_MS = 5_000;
+const STOP_GRACE_PERIOD_MS = 5_000;
+const STOP_POLL_INTERVAL_MS = 50;
+export const BACKGROUND_RUNTIME_READY_TIMEOUT_MS = CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS + PROCESS_STARTUP_GRACE_MS;
+export async function startBackgroundRuntime(opts) {
+    await acquireRuntimeStartLock(opts.configPath);
+    try {
+        await stopBackgroundRuntime(opts.configPath);
+        const logFile = runtimeLogPath(opts.configPath);
+        mkdirSync(dirname(runtimeStatePath(opts.configPath)), { recursive: true });
+        const logFd = openSync(logFile, "a", 0o600);
+        chmodSync(logFile, 0o600);
+        const runArgs = [opts.binaryPath, "_run", "--config", opts.configPath];
+        if (opts.verbose)
+            runArgs.push("--verbose");
+        let child;
+        try {
+            child = spawn(process.execPath, runArgs, {
+                cwd: opts.projectDirs[0] ?? process.cwd(),
+                detached: true,
+                env: process.env,
+                stdio: ["ignore", logFd, logFd, "ipc"],
+            });
+        }
+        finally {
+            closeSync(logFd);
+        }
+        if (child.pid == null) {
+            child.kill();
+            throw new Error(`could not start the background runtime; see ${logFile}`);
+        }
+        const pid = child.pid;
+        writeRuntimeState(opts.configPath, pid, opts.projectDirs);
+        try {
+            await waitUntilReady(child, opts.readyTimeoutMs ?? BACKGROUND_RUNTIME_READY_TIMEOUT_MS);
+        }
+        catch (error) {
+            if (child.connected)
+                child.disconnect();
+            await terminateProcess(pid);
+            removeRuntimeState(opts.configPath);
+            throw error;
+        }
+        if (child.connected)
+            child.disconnect();
+        child.unref();
+        return {
+            running: true,
+            pid,
+            projects: opts.projectDirs,
+            log_file: logFile,
+        };
+    }
+    finally {
+        releaseRuntimeStartLock(opts.configPath);
+    }
+}
+/**
+ * Record a running runtime so a later launch can find and stop it. Used both by
+ * the detached launcher (child PID) and by a `--foreground` session (its own
+ * PID), so the two modes share one source of truth and never coexist on the
+ * same device token.
+ */
+export function writeRuntimeState(configPath, pid, projects) {
+    const statePath = runtimeStatePath(configPath);
+    mkdirSync(dirname(statePath), { recursive: true });
+    writePrivateJson(statePath, { pid, projects });
+}
+export function clearRuntimeState(configPath) {
+    removeRuntimeState(configPath);
+}
+export async function stopBackgroundRuntime(configPath) {
+    const state = readRuntimeState(configPath);
+    if (!state)
+        return false;
+    await terminateProcess(state.pid);
+    removeRuntimeState(configPath);
+    return true;
+}
+export function backgroundRuntimeStatus(configPath) {
+    const state = readRuntimeState(configPath);
+    if (!state) {
+        return { running: false, pid: null, projects: [], log_file: runtimeLogPath(configPath) };
+    }
+    if (!processIsRunning(state.pid)) {
+        removeRuntimeState(configPath);
+        return {
+            running: false,
+            pid: null,
+            projects: state.projects,
+            log_file: runtimeLogPath(configPath),
+        };
+    }
+    return {
+        running: true,
+        pid: state.pid,
+        projects: state.projects,
+        log_file: runtimeLogPath(configPath),
+    };
+}
+function waitUntilReady(child, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let timeout;
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.removeListener("error", onError);
+            child.removeListener("exit", onExit);
+            child.removeListener("message", onMessage);
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onExit = (code) => {
+            cleanup();
+            reject(new Error(`background runtime exited before connecting (exit ${code ?? "unknown"})`));
+        };
+        const onMessage = (message) => {
+            if (!message || typeof message !== "object" || message.type !== "ready")
+                return;
+            cleanup();
+            resolve();
+        };
+        timeout = setTimeout(() => {
+            cleanup();
+            reject(new Error(`background runtime did not connect within ${timeoutMs}ms`));
+        }, timeoutMs);
+        child.once("error", onError);
+        child.once("exit", onExit);
+        child.on("message", onMessage);
+    });
+}
+function runtimeStatePath(configPath) {
+    return join(dirname(configPath), "cloud-runtime.json");
+}
+function runtimeLogPath(configPath) {
+    return join(dirname(configPath), "cloud-runtime.log");
+}
+function runtimeStartLockPath(configPath) {
+    return join(dirname(configPath), "cloud-runtime.start.lock");
+}
+async function acquireRuntimeStartLock(configPath) {
+    const lockPath = runtimeStartLockPath(configPath);
+    mkdirSync(dirname(lockPath), { recursive: true });
+    // Match worst-case `startBackgroundRuntime` hold time: stop prior runtime, wait for
+    // ready, and tear down the child if ready fails, plus one poll interval.
+    const deadline = Date.now()
+        + BACKGROUND_RUNTIME_READY_TIMEOUT_MS
+        + 2 * (STOP_GRACE_PERIOD_MS + FORCED_STOP_TIMEOUT_MS)
+        + STOP_POLL_INTERVAL_MS;
+    while (Date.now() < deadline) {
+        try {
+            const fd = openSync(lockPath, "wx");
+            writeFileSync(fd, `${process.pid}\n`, "utf8");
+            closeSync(fd);
+            return;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            try {
+                const ownerPid = readRuntimeStartLockOwner(lockPath);
+                const incompleteLockIsStale = ownerPid === null
+                    && Date.now() - statSync(lockPath).mtimeMs > 1_000;
+                if ((ownerPid !== null && !processIsRunning(ownerPid)) || incompleteLockIsStale) {
+                    unlinkSync(lockPath);
+                    continue;
+                }
+            }
+            catch {
+                // Another process may have released the lock; retry.
+            }
+            await new Promise((resolve) => setTimeout(resolve, STOP_POLL_INTERVAL_MS));
+        }
+    }
+    throw new Error("timed out waiting for the background runtime start lock");
+}
+function releaseRuntimeStartLock(configPath) {
+    const lockPath = runtimeStartLockPath(configPath);
+    if (readRuntimeStartLockOwner(lockPath) !== process.pid)
+        return;
+    try {
+        unlinkSync(lockPath);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+}
+function readRuntimeStartLockOwner(lockPath) {
+    try {
+        const pid = Number.parseInt(readFileSync(lockPath, "utf8").trim(), 10);
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+function readRuntimeState(configPath) {
+    try {
+        const value = JSON.parse(readFileSync(runtimeStatePath(configPath), "utf8"));
+        const pid = value.pid;
+        if (typeof pid !== "number" || !Number.isInteger(pid) || pid <= 0 || !Array.isArray(value.projects))
+            return null;
+        return {
+            pid,
+            projects: value.projects.filter((project) => typeof project === "string"),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function processIsRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+async function waitForProcessExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (processIsRunning(pid)) {
+        if (Date.now() >= deadline)
+            return false;
+        await new Promise((resolve) => setTimeout(resolve, STOP_POLL_INTERVAL_MS));
+    }
+    return true;
+}
+async function terminateProcess(pid) {
+    signalProcess(pid, "SIGTERM");
+    if (await waitForProcessExit(pid, STOP_GRACE_PERIOD_MS))
+        return;
+    signalProcess(pid, "SIGKILL");
+    if (!await waitForProcessExit(pid, FORCED_STOP_TIMEOUT_MS)) {
+        throw new Error(`background runtime PID ${pid} did not stop`);
+    }
+}
+function signalProcess(pid, signal) {
+    try {
+        process.kill(pid, signal);
+    }
+    catch (error) {
+        if (error.code !== "ESRCH")
+            throw error;
+    }
+}
+function removeRuntimeState(configPath) {
+    try {
+        unlinkSync(runtimeStatePath(configPath));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+}
+function writePrivateJson(path, value) {
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    chmodSync(path, 0o600);
+}
+//# sourceMappingURL=runtime-process.js.map

package/packages/gsd-cloud/dist/runtime-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-process.js","sourceRoot":"","sources":["../src/runtime-process.ts"],"names":[],"mappings":"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","sourcesContent":["// Project/App: Open GSD\n// File Purpose: Detached cloud runtime process lifecycle and status persistence.\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport {\n  chmodSync,\n  closeSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS } from \"./cloud-runtime.js\";\n\ninterface RuntimeProcessState {\n  pid: number;\n  projects: string[];\n}\n\nexport interface RuntimeProcessStatus {\n  running: boolean;\n  pid: number | null;\n  projects: string[];\n  log_file: string;\n}\n\ninterface StartRuntimeOptions {\n  binaryPath: string;\n  configPath: string;\n  projectDirs: string[];\n  readyTimeoutMs?: number;\n  verbose?: boolean;\n}\n\nconst PROCESS_STARTUP_GRACE_MS = 5_000;\nconst FORCED_STOP_TIMEOUT_MS = 5_000;\nconst STOP_GRACE_PERIOD_MS = 5_000;\nconst STOP_POLL_INTERVAL_MS = 50;\n\nexport const BACKGROUND_RUNTIME_READY_TIMEOUT_MS =\n  CLOUD_RUNTIME_INITIAL_CONNECT_WINDOW_MS + PROCESS_STARTUP_GRACE_MS;\n\nexport async function startBackgroundRuntime(opts: StartRuntimeOptions): Promise<RuntimeProcessStatus> {\n  await acquireRuntimeStartLock(opts.configPath);\n  try {\n    await stopBackgroundRuntime(opts.configPath);\n\n    const logFile = runtimeLogPath(opts.configPath);\n    mkdirSync(dirname(runtimeStatePath(opts.configPath)), { recursive: true });\n    const logFd = openSync(logFile, \"a\", 0o600);\n    chmodSync(logFile, 0o600);\n    const runArgs = [opts.binaryPath, \"_run\", \"--config\", opts.configPath];\n    if (opts.verbose) runArgs.push(\"--verbose\");\n    let child: ChildProcess;\n    try {\n      child = spawn(process.execPath, runArgs, {\n        cwd: opts.projectDirs[0] ?? process.cwd(),\n        detached: true,\n        env: process.env,\n        stdio: [\"ignore\", logFd, logFd, \"ipc\"],\n      });\n    } finally {\n      closeSync(logFd);\n    }\n\n    if (child.pid == null) {\n      child.kill();\n      throw new Error(`could not start the background runtime; see ${logFile}`);\n    }\n    const pid = child.pid;\n\n    writeRuntimeState(opts.configPath, pid, opts.projectDirs);\n\n    try {\n      await waitUntilReady(child, opts.readyTimeoutMs ?? BACKGROUND_RUNTIME_READY_TIMEOUT_MS);\n    } catch (error) {\n      if (child.connected) child.disconnect();\n      await terminateProcess(pid);\n      removeRuntimeState(opts.configPath);\n      throw error;\n    }\n\n    if (child.connected) child.disconnect();\n    child.unref();\n\n    return {\n      running: true,\n      pid,\n      projects: opts.projectDirs,\n      log_file: logFile,\n    };\n  } finally {\n    releaseRuntimeStartLock(opts.configPath);\n  }\n}\n\n/**\n * Record a running runtime so a later launch can find and stop it. Used both by\n * the detached launcher (child PID) and by a `--foreground` session (its own\n * PID), so the two modes share one source of truth and never coexist on the\n * same device token.\n */\nexport function writeRuntimeState(configPath: string, pid: number, projects: string[]): void {\n  const statePath = runtimeStatePath(configPath);\n  mkdirSync(dirname(statePath), { recursive: true });\n  writePrivateJson(statePath, { pid, projects } satisfies RuntimeProcessState);\n}\n\nexport function clearRuntimeState(configPath: string): void {\n  removeRuntimeState(configPath);\n}\n\nexport async function stopBackgroundRuntime(configPath: string): Promise<boolean> {\n  const state = readRuntimeState(configPath);\n  if (!state) return false;\n  await terminateProcess(state.pid);\n  removeRuntimeState(configPath);\n  return true;\n}\n\nexport function backgroundRuntimeStatus(configPath: string): RuntimeProcessStatus {\n  const state = readRuntimeState(configPath);\n  if (!state) {\n    return { running: false, pid: null, projects: [], log_file: runtimeLogPath(configPath) };\n  }\n  if (!processIsRunning(state.pid)) {\n    removeRuntimeState(configPath);\n    return {\n      running: false,\n      pid: null,\n      projects: state.projects,\n      log_file: runtimeLogPath(configPath),\n    };\n  }\n  return {\n    running: true,\n    pid: state.pid,\n    projects: state.projects,\n    log_file: runtimeLogPath(configPath),\n  };\n}\n\nfunction waitUntilReady(child: ChildProcess, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    let timeout: ReturnType<typeof setTimeout>;\n    const cleanup = (): void => {\n      clearTimeout(timeout);\n      child.removeListener(\"error\", onError);\n      child.removeListener(\"exit\", onExit);\n      child.removeListener(\"message\", onMessage);\n    };\n    const onError = (error: Error): void => {\n      cleanup();\n      reject(error);\n    };\n    const onExit = (code: number | null): void => {\n      cleanup();\n      reject(new Error(`background runtime exited before connecting (exit ${code ?? \"unknown\"})`));\n    };\n    const onMessage = (message: unknown): void => {\n      if (!message || typeof message !== \"object\" || (message as { type?: unknown }).type !== \"ready\") return;\n      cleanup();\n      resolve();\n    };\n    timeout = setTimeout(() => {\n      cleanup();\n      reject(new Error(`background runtime did not connect within ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    child.once(\"error\", onError);\n    child.once(\"exit\", onExit);\n    child.on(\"message\", onMessage);\n  });\n}\n\nfunction runtimeStatePath(configPath: string): string {\n  return join(dirname(configPath), \"cloud-runtime.json\");\n}\n\nfunction runtimeLogPath(configPath: string): string {\n  return join(dirname(configPath), \"cloud-runtime.log\");\n}\n\nfunction runtimeStartLockPath(configPath: string): string {\n  return join(dirname(configPath), \"cloud-runtime.start.lock\");\n}\n\nasync function acquireRuntimeStartLock(configPath: string): Promise<void> {\n  const lockPath = runtimeStartLockPath(configPath);\n  mkdirSync(dirname(lockPath), { recursive: true });\n  // Match worst-case `startBackgroundRuntime` hold time: stop prior runtime, wait for\n  // ready, and tear down the child if ready fails, plus one poll interval.\n  const deadline = Date.now()\n    + BACKGROUND_RUNTIME_READY_TIMEOUT_MS\n    + 2 * (STOP_GRACE_PERIOD_MS + FORCED_STOP_TIMEOUT_MS)\n    + STOP_POLL_INTERVAL_MS;\n  while (Date.now() < deadline) {\n    try {\n      const fd = openSync(lockPath, \"wx\");\n      writeFileSync(fd, `${process.pid}\\n`, \"utf8\");\n      closeSync(fd);\n      return;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n      try {\n        const ownerPid = readRuntimeStartLockOwner(lockPath);\n        const incompleteLockIsStale = ownerPid === null\n          && Date.now() - statSync(lockPath).mtimeMs > 1_000;\n        if ((ownerPid !== null && !processIsRunning(ownerPid)) || incompleteLockIsStale) {\n          unlinkSync(lockPath);\n          continue;\n        }\n      } catch {\n        // Another process may have released the lock; retry.\n      }\n      await new Promise((resolve) => setTimeout(resolve, STOP_POLL_INTERVAL_MS));\n    }\n  }\n  throw new Error(\"timed out waiting for the background runtime start lock\");\n}\n\nfunction releaseRuntimeStartLock(configPath: string): void {\n  const lockPath = runtimeStartLockPath(configPath);\n  if (readRuntimeStartLockOwner(lockPath) !== process.pid) return;\n  try {\n    unlinkSync(lockPath);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n  }\n}\n\nfunction readRuntimeStartLockOwner(lockPath: string): number | null {\n  try {\n    const pid = Number.parseInt(readFileSync(lockPath, \"utf8\").trim(), 10);\n    return Number.isInteger(pid) && pid > 0 ? pid : null;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\n    throw error;\n  }\n}\n\nfunction readRuntimeState(configPath: string): RuntimeProcessState | null {\n  try {\n    const value = JSON.parse(readFileSync(runtimeStatePath(configPath), \"utf8\")) as Partial<RuntimeProcessState>;\n    const pid = value.pid;\n    if (typeof pid !== \"number\" || !Number.isInteger(pid) || pid <= 0 || !Array.isArray(value.projects)) return null;\n    return {\n      pid,\n      projects: value.projects.filter((project): project is string => typeof project === \"string\"),\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction processIsRunning(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return (error as NodeJS.ErrnoException).code === \"EPERM\";\n  }\n}\n\nasync function waitForProcessExit(pid: number, timeoutMs: number): Promise<boolean> {\n  const deadline = Date.now() + timeoutMs;\n  while (processIsRunning(pid)) {\n    if (Date.now() >= deadline) return false;\n    await new Promise((resolve) => setTimeout(resolve, STOP_POLL_INTERVAL_MS));\n  }\n  return true;\n}\n\nasync function terminateProcess(pid: number): Promise<void> {\n  signalProcess(pid, \"SIGTERM\");\n  if (await waitForProcessExit(pid, STOP_GRACE_PERIOD_MS)) return;\n  signalProcess(pid, \"SIGKILL\");\n  if (!await waitForProcessExit(pid, FORCED_STOP_TIMEOUT_MS)) {\n    throw new Error(`background runtime PID ${pid} did not stop`);\n  }\n}\n\nfunction signalProcess(pid: number, signal: NodeJS.Signals): void {\n  try {\n    process.kill(pid, signal);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ESRCH\") throw error;\n  }\n}\n\nfunction removeRuntimeState(configPath: string): void {\n  try {\n    unlinkSync(runtimeStatePath(configPath));\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n  }\n}\n\nfunction writePrivateJson(path: string, value: unknown): void {\n  writeFileSync(path, `${JSON.stringify(value, null, 2)}\\n`, { encoding: \"utf8\", mode: 0o600 });\n  chmodSync(path, 0o600);\n}\n"]}

package/packages/gsd-cloud/dist/runtime-process.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-process.test.d.ts.map

package/packages/gsd-cloud/dist/runtime-process.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-process.test.d.ts","sourceRoot":"","sources":["../src/runtime-process.test.ts"],"names":[],"mappings":""}