clinkx 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/clinkx-workflows/dist/dashboard-ui/assets/{index-DSOtuS0p.js → index-CX4FrhYN.js} +1 -1
  3. package/clinkx-workflows/dist/dashboard-ui/index.html +1 -1
  4. package/clinkx-workflows/dist/settings/registry.js +5 -0
  5. package/clinkx-workflows/dist/settings/registry.js.map +1 -1
  6. package/dist/dashboard-cli.d.ts +11 -3
  7. package/dist/dashboard-cli.js +149 -32
  8. package/dist/dashboard-cli.js.map +1 -1
  9. package/dist/dashboard-companion/client.d.ts +14 -0
  10. package/dist/dashboard-companion/client.js +16 -0
  11. package/dist/dashboard-companion/client.js.map +1 -1
  12. package/dist/dashboard-companion/credential-expectation.d.ts +23 -0
  13. package/dist/dashboard-companion/credential-expectation.js +50 -0
  14. package/dist/dashboard-companion/credential-expectation.js.map +1 -0
  15. package/dist/dashboard-companion/host-channel.d.ts +36 -0
  16. package/dist/dashboard-companion/host-channel.js +78 -0
  17. package/dist/dashboard-companion/host-channel.js.map +1 -0
  18. package/dist/dashboard-companion/host-status.d.ts +179 -0
  19. package/dist/dashboard-companion/host-status.js +122 -0
  20. package/dist/dashboard-companion/host-status.js.map +1 -0
  21. package/dist/dashboard-companion/standalone-assets.d.ts +8 -0
  22. package/dist/dashboard-companion/standalone-assets.js +7 -1
  23. package/dist/dashboard-companion/standalone-assets.js.map +1 -1
  24. package/dist/dashboard-companion/standalone-entry.js +34 -13
  25. package/dist/dashboard-companion/standalone-entry.js.map +1 -1
  26. package/dist/desktop-host/child-env.d.ts +23 -0
  27. package/dist/desktop-host/child-env.js +70 -0
  28. package/dist/desktop-host/child-env.js.map +1 -0
  29. package/dist/desktop-host/daemon-entry.d.ts +2 -0
  30. package/dist/desktop-host/daemon-entry.js +50 -0
  31. package/dist/desktop-host/daemon-entry.js.map +1 -0
  32. package/dist/desktop-host/daemon-env.d.ts +12 -0
  33. package/dist/desktop-host/daemon-env.js +35 -0
  34. package/dist/desktop-host/daemon-env.js.map +1 -0
  35. package/dist/desktop-host/daemon-protocol.d.ts +210 -0
  36. package/dist/desktop-host/daemon-protocol.js +56 -0
  37. package/dist/desktop-host/daemon-protocol.js.map +1 -0
  38. package/dist/desktop-host/daemon.d.ts +50 -0
  39. package/dist/desktop-host/daemon.js +441 -0
  40. package/dist/desktop-host/daemon.js.map +1 -0
  41. package/dist/desktop-host/enrollment.d.ts +17 -0
  42. package/dist/desktop-host/enrollment.js +25 -0
  43. package/dist/desktop-host/enrollment.js.map +1 -0
  44. package/dist/desktop-host/import.d.ts +14 -0
  45. package/dist/desktop-host/import.js +95 -0
  46. package/dist/desktop-host/import.js.map +1 -0
  47. package/dist/desktop-host/profile.d.ts +130 -0
  48. package/dist/desktop-host/profile.js +176 -0
  49. package/dist/desktop-host/profile.js.map +1 -0
  50. package/dist/desktop-host/service.d.ts +6 -0
  51. package/dist/desktop-host/service.js +7 -0
  52. package/dist/desktop-host/service.js.map +1 -0
  53. package/dist/desktop-host/supervisor.d.ts +57 -0
  54. package/dist/desktop-host/supervisor.js +256 -0
  55. package/dist/desktop-host/supervisor.js.map +1 -0
  56. package/dist/desktop-host/view-state.d.ts +138 -0
  57. package/dist/desktop-host/view-state.js +27 -0
  58. package/dist/desktop-host/view-state.js.map +1 -0
  59. package/dist/registry.d.ts +7 -0
  60. package/dist/registry.js +21 -7
  61. package/dist/registry.js.map +1 -1
  62. package/docs/verification/README.md +28 -2
  63. package/docs/verification/workflow-handoff.md +86 -0
  64. package/package.json +2 -2
@@ -0,0 +1,122 @@
1
+ import { z } from "zod";
2
+ /**
3
+ * Status channel between the dashboard companion and the launcher that
4
+ * supervises it (`--host-managed`): one JSON object per line on the
5
+ * companion's stdout. It is private to the parent process, so the transient
6
+ * enrollment code travels here instead of into stderr logs. The companion and
7
+ * its launcher ship as a pair; readers ignore unknown event types and unknown
8
+ * keys so a later companion can add fields, but refuse another major version.
9
+ */
10
+ export const HOST_STATUS_VERSION = 1;
11
+ export const MAX_HOST_STATUS_LINE_BYTES = 4_096;
12
+ const MAX_FATAL_MESSAGE_LENGTH = 1_000;
13
+ export const HostGatewayStateSchema = z.enum([
14
+ "connecting",
15
+ "open",
16
+ "accepted",
17
+ "rejected",
18
+ "refused",
19
+ "closed",
20
+ ]);
21
+ export const HostSettingsStateSchema = z.enum(["available", "off", "invalid", "unresolvable"]);
22
+ const version = z.literal(HOST_STATUS_VERSION);
23
+ export const HostStatusEventSchema = z.discriminatedUnion("type", [
24
+ z.object({
25
+ v: version,
26
+ type: z.literal("starting"),
27
+ pid: z.number().int().positive(),
28
+ mode: z.enum(["local", "remote", "gateway"]),
29
+ }),
30
+ z.object({ v: version, type: z.literal("settings"), state: HostSettingsStateSchema }),
31
+ z.object({
32
+ v: version,
33
+ type: z.literal("listening"),
34
+ origin: z.string().min(1).max(512),
35
+ port: z.number().int().min(1).max(65_535),
36
+ }),
37
+ z.object({
38
+ v: version,
39
+ type: z.literal("enrollment_code"),
40
+ code: z.string().regex(/^[A-Za-z0-9_-]{16,128}$/),
41
+ }),
42
+ z.object({
43
+ v: version,
44
+ type: z.literal("gateway"),
45
+ state: HostGatewayStateSchema,
46
+ status: z.number().int().min(100).max(599).optional(),
47
+ }),
48
+ z.object({ v: version, type: z.literal("ready") }),
49
+ z.object({ v: version, type: z.literal("stopping"), reason: z.enum(["signal", "host_request"]) }),
50
+ z.object({
51
+ v: version,
52
+ type: z.literal("fatal"),
53
+ reason: z.string().regex(/^[a-z][a-z0-9_]{0,63}$/),
54
+ message: z.string().max(MAX_FATAL_MESSAGE_LENGTH),
55
+ }),
56
+ // Daemon-level events (the host daemon sits between a shell and the
57
+ // companion). Additive to v1: readers built before them ignore them.
58
+ z.object({ v: version, type: z.literal("state"), state: z.record(z.string(), z.unknown()) }),
59
+ z.object({
60
+ v: version,
61
+ type: z.literal("response"),
62
+ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
63
+ ok: z.boolean(),
64
+ result: z.unknown().optional(),
65
+ error: z.string().max(MAX_FATAL_MESSAGE_LENGTH).optional(),
66
+ }),
67
+ // The shell owns the OS keychain: the daemon hands it a newly entered key
68
+ // over this private pipe and waits for the shell's key-stored reply.
69
+ z.object({ v: version, type: z.literal("store_key"), key: z.string().min(1).max(256) }),
70
+ ]);
71
+ const KNOWN_TYPES = new Set(HostStatusEventSchema.options.map((option) => option.shape.type.value));
72
+ export class HostStatusProtocolError extends Error {
73
+ constructor(message) {
74
+ super(message);
75
+ this.name = "HostStatusProtocolError";
76
+ }
77
+ }
78
+ /** Serialize one event as a bounded line; a producer bug throws instead of emitting an unreadable line. */
79
+ export function formatHostStatusEvent(event) {
80
+ const parsed = HostStatusEventSchema.parse({ v: HOST_STATUS_VERSION, ...event });
81
+ const line = `${JSON.stringify(parsed)}\n`;
82
+ if (Buffer.byteLength(line) > MAX_HOST_STATUS_LINE_BYTES) {
83
+ throw new HostStatusProtocolError(`host status event exceeds ${String(MAX_HOST_STATUS_LINE_BYTES)} bytes`);
84
+ }
85
+ return line;
86
+ }
87
+ /** `undefined` for an event type this reader does not know; malformed or foreign-version input throws. */
88
+ export function parseHostStatusLine(line) {
89
+ if (Buffer.byteLength(line) > MAX_HOST_STATUS_LINE_BYTES) {
90
+ throw new HostStatusProtocolError(`host status line exceeds ${String(MAX_HOST_STATUS_LINE_BYTES)} bytes`);
91
+ }
92
+ let value;
93
+ try {
94
+ value = JSON.parse(line);
95
+ }
96
+ catch {
97
+ throw new HostStatusProtocolError("host status line is not JSON");
98
+ }
99
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
100
+ throw new HostStatusProtocolError("host status line is not a JSON object");
101
+ }
102
+ const record = value;
103
+ if (record["v"] !== HOST_STATUS_VERSION) {
104
+ throw new HostStatusProtocolError(`unsupported host status version ${JSON.stringify(record["v"])}`);
105
+ }
106
+ if (typeof record["type"] !== "string" || !KNOWN_TYPES.has(record["type"]))
107
+ return undefined;
108
+ const parsed = HostStatusEventSchema.safeParse(record);
109
+ if (!parsed.success) {
110
+ throw new HostStatusProtocolError(`invalid ${record["type"]} host status event`);
111
+ }
112
+ return parsed.data;
113
+ }
114
+ /** Bound a startup failure for the channel: one line, no control characters. */
115
+ export function hostFatalMessage(error) {
116
+ const raw = error instanceof Error ? error.message : String(error);
117
+ const flattened = raw.replace(/[\u0000-\u001f\u007f]+/g, " ").trim();
118
+ return flattened.length <= MAX_FATAL_MESSAGE_LENGTH
119
+ ? flattened
120
+ : `${flattened.slice(0, MAX_FATAL_MESSAGE_LENGTH - 12)} [truncated]`;
121
+ }
122
+ //# sourceMappingURL=host-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host-status.js","sourceRoot":"","sources":["../../src/dashboard-companion/host-status.ts"],"names":[],"mappings":"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"}
@@ -5,8 +5,16 @@ export interface StandaloneAssetSource {
5
5
  export interface MaterializedStandaloneRuntime {
6
6
  readonly root: string;
7
7
  readonly dashboardStaticRoot: string;
8
+ /** Shipped adapter catalog: the built-in discovery tier and prompt_file fallback. */
9
+ readonly adaptersRoot: string;
8
10
  readonly cleanup: () => void;
9
11
  }
10
12
  /** Materialize immutable SEA assets into a private, process-owned runtime tree. */
11
13
  export declare function materializeStandaloneRuntime(source?: StandaloneAssetSource): MaterializedStandaloneRuntime;
14
+ /**
15
+ * Point the package-relative workflow and template defaults at the extracted
16
+ * tree. Adapters are not set here: CLINKX_CONFIG_PATH would replace the
17
+ * user's adapter tiers, so the entry registers `adaptersRoot` as the built-in
18
+ * tier instead, and an explicit CLINKX_CONFIG_PATH keeps its npm meaning.
19
+ */
12
20
  export declare function prepareStandaloneEnvironment(env: NodeJS.ProcessEnv): MaterializedStandaloneRuntime;
@@ -52,6 +52,7 @@ export function materializeStandaloneRuntime(source = {
52
52
  return {
53
53
  root,
54
54
  dashboardStaticRoot,
55
+ adaptersRoot: join(root, "conf", "adapters"),
55
56
  cleanup: () => rmSync(root, { force: true, recursive: true }),
56
57
  };
57
58
  }
@@ -60,11 +61,16 @@ export function materializeStandaloneRuntime(source = {
60
61
  throw error;
61
62
  }
62
63
  }
64
+ /**
65
+ * Point the package-relative workflow and template defaults at the extracted
66
+ * tree. Adapters are not set here: CLINKX_CONFIG_PATH would replace the
67
+ * user's adapter tiers, so the entry registers `adaptersRoot` as the built-in
68
+ * tier instead, and an explicit CLINKX_CONFIG_PATH keeps its npm meaning.
69
+ */
63
70
  export function prepareStandaloneEnvironment(env) {
64
71
  if (!isSea())
65
72
  throw new Error("standalone entry must run inside a Node SEA executable");
66
73
  const runtime = materializeStandaloneRuntime();
67
- env["CLINKX_CONFIG_PATH"] ??= join(runtime.root, "conf", "adapters");
68
74
  env["CLINKX_WORKFLOWS_PATH"] ??= join(runtime.root, "workflows");
69
75
  env["CLINKX_WORKFLOWS_TEMPLATES_PATH"] ??= join(runtime.root, "templates");
70
76
  return runtime;
@@ -1 +1 @@
1
- {"version":3,"file":"standalone-assets.js","sourceRoot":"","sources":["../../src/dashboard-companion/standalone-assets.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"standalone-assets.js","sourceRoot":"","sources":["../../src/dashboard-companion/standalone-assets.ts"],"names":[],"mappings":"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"}
@@ -1,17 +1,38 @@
1
+ import { setBuiltinAdaptersDirectory } from "../registry.js";
1
2
  import { prepareStandaloneEnvironment } from "./standalone-assets.js";
2
- process.env["CLINKX_DASHBOARD_STANDALONE_ENTRY"] = "1";
3
- const runtime = prepareStandaloneEnvironment(process.env);
4
- process.once("exit", runtime.cleanup);
5
- const { runDashboardCli } = await import("../dashboard-cli.js");
6
- delete process.env["CLINKX_DASHBOARD_STANDALONE_ENTRY"];
7
- try {
8
- await runDashboardCli(process.argv.slice(2), process.env, {
9
- staticRoot: runtime.dashboardStaticRoot,
10
- });
3
+ // One executable, two roles: `--host-daemon` supervises a child of this same
4
+ // binary running the dashboard companion; anything else runs the companion.
5
+ const hostDaemon = process.argv[2] === "--host-daemon";
6
+ if (hostDaemon) {
7
+ await import("../desktop-host/daemon-entry.js");
11
8
  }
12
- catch (error) {
13
- const message = error instanceof Error ? error.message : String(error);
14
- process.stderr.write(`clinkx-dashboard: ${message}\n`);
15
- process.exitCode = 1;
9
+ else {
10
+ process.env["CLINKX_DASHBOARD_STANDALONE_ENTRY"] = "1";
11
+ // A preparation failure (for example a TMPDIR that does not exist) must
12
+ // surface as this executable's own one-line fatal, not an uncaught
13
+ // exception whose stack a supervising host can only quote uselessly.
14
+ let runtime;
15
+ try {
16
+ runtime = prepareStandaloneEnvironment(process.env);
17
+ }
18
+ catch (error) {
19
+ const message = error instanceof Error ? error.message : String(error);
20
+ process.stderr.write(`clinkx-dashboard: ${message}\n`);
21
+ process.exit(1);
22
+ }
23
+ process.once("exit", runtime.cleanup);
24
+ setBuiltinAdaptersDirectory(runtime.adaptersRoot);
25
+ const { runDashboardCli } = await import("../dashboard-cli.js");
26
+ delete process.env["CLINKX_DASHBOARD_STANDALONE_ENTRY"];
27
+ try {
28
+ await runDashboardCli(process.argv.slice(2), process.env, {
29
+ staticRoot: runtime.dashboardStaticRoot,
30
+ });
31
+ }
32
+ catch (error) {
33
+ const message = error instanceof Error ? error.message : String(error);
34
+ process.stderr.write(`clinkx-dashboard: ${message}\n`);
35
+ process.exitCode = 1;
36
+ }
16
37
  }
17
38
  //# sourceMappingURL=standalone-entry.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"standalone-entry.js","sourceRoot":"","sources":["../../src/dashboard-companion/standalone-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,GAAG,GAAG,CAAC;AACvD,MAAM,OAAO,GAAG,4BAA4B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAChE,OAAO,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAExD,IAAI,CAAC;IACH,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE;QACxD,UAAU,EAAE,OAAO,CAAC,mBAAmB;KACxC,CAAC,CAAC;AACL,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}
1
+ {"version":3,"file":"standalone-entry.js","sourceRoot":"","sources":["../../src/dashboard-companion/standalone-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC;AACvD,IAAI,UAAU,EAAE,CAAC;IACf,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;AAClD,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,GAAG,GAAG,CAAC;IACvD,wEAAwE;IACxE,mEAAmE;IACnE,qEAAqE;IACrE,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,4BAA4B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,2BAA2B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAElD,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE;YACxD,UAAU,EAAE,OAAO,CAAC,mBAAmB;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
@@ -0,0 +1,23 @@
1
+ import type { DesktopProfile } from "./profile.js";
2
+ /** Whether `key` has the grammar the profile's gateway mode accepts. */
3
+ export declare function isWorkstationKeyForMode(key: string, mode: DesktopProfile["service"]["mode"]): boolean;
4
+ export interface CompanionEnvironmentInput {
5
+ readonly profile: DesktopProfile;
6
+ readonly workstationKey: string;
7
+ /** The user's home directory, resolved by the host (not taken from the ambient environment). */
8
+ readonly home: string;
9
+ readonly tmpdir: string;
10
+ readonly platform: NodeJS.Platform;
11
+ /** Source of the OS baseline only. */
12
+ readonly ambient: NodeJS.ProcessEnv;
13
+ }
14
+ /**
15
+ * The companion's complete environment. A packaged Node runtime does not get
16
+ * the SEA's protection from ambient startup options, so nothing is inherited
17
+ * wholesale: NODE_OPTIONS, NODE_PATH, dynamic-loader variables (DYLD_*,
18
+ * LD_*), proxies, and terminal configuration never reach the child. The key
19
+ * travels only here, never in argv, where other local users could read it.
20
+ */
21
+ export declare function buildCompanionEnvironment(input: CompanionEnvironmentInput): Record<string, string>;
22
+ /** Arguments for a supervised start; the listener port is ephemeral because only the gateway tunnel reaches it. */
23
+ export declare function buildCompanionArguments(profile: DesktopProfile): string[];
@@ -0,0 +1,70 @@
1
+ import { isDashboardPairingToken } from "../dashboard-pairing-token.js";
2
+ import { isDeviceApiKey } from "../dashboard-companion/config.js";
3
+ /** Windows variables Node and the OS need to start a process; nothing else is inherited. */
4
+ const WINDOWS_BASELINE = [
5
+ "SystemRoot",
6
+ "windir",
7
+ "SystemDrive",
8
+ "ProgramData",
9
+ "APPDATA",
10
+ "LOCALAPPDATA",
11
+ "USERPROFILE",
12
+ "TEMP",
13
+ "TMP",
14
+ ];
15
+ /** Locale only: the companion spawns nothing, so no search path or tool configuration is needed. */
16
+ const POSIX_BASELINE = ["LANG", "LC_ALL", "LC_CTYPE", "TZ"];
17
+ /** Whether `key` has the grammar the profile's gateway mode accepts. */
18
+ export function isWorkstationKeyForMode(key, mode) {
19
+ return mode === "tenant" ? isDeviceApiKey(key) : isDashboardPairingToken(key);
20
+ }
21
+ /**
22
+ * The companion's complete environment. A packaged Node runtime does not get
23
+ * the SEA's protection from ambient startup options, so nothing is inherited
24
+ * wholesale: NODE_OPTIONS, NODE_PATH, dynamic-loader variables (DYLD_*,
25
+ * LD_*), proxies, and terminal configuration never reach the child. The key
26
+ * travels only here, never in argv, where other local users could read it.
27
+ */
28
+ export function buildCompanionEnvironment(input) {
29
+ const { profile } = input;
30
+ if (!isWorkstationKeyForMode(input.workstationKey, profile.service.mode)) {
31
+ throw new Error(profile.service.mode === "tenant"
32
+ ? "the workstation key must be a clxd_ API key from the ClinkX workspace screen"
33
+ : "the pairing token must be the gateway's 43-character pairing secret");
34
+ }
35
+ const env = {};
36
+ const baseline = input.platform === "win32" ? WINDOWS_BASELINE : POSIX_BASELINE;
37
+ for (const name of baseline) {
38
+ const value = input.ambient[name];
39
+ if (value !== undefined && value !== "")
40
+ env[name] = value;
41
+ }
42
+ if (input.platform !== "win32")
43
+ env["PATH"] = "/usr/bin:/bin";
44
+ env["HOME"] = input.home;
45
+ if (input.platform === "win32")
46
+ env["USERPROFILE"] = input.home;
47
+ else
48
+ env["TMPDIR"] = input.tmpdir;
49
+ Object.assign(env, {
50
+ CLINKX_WORKFLOWS_DASHBOARD_AUTH_MODE: "passkey",
51
+ CLINKX_WORKFLOWS_DASHBOARD_PUBLIC_API_ORIGIN: profile.service.origin,
52
+ CLINKX_WORKFLOWS_DASHBOARD_UI_ORIGIN: profile.service.origin,
53
+ CLINKX_DASHBOARD_GATEWAY_URL: profile.service.gatewayUrl,
54
+ CLINKX_DASHBOARD_GATEWAY_TOKEN: input.workstationKey,
55
+ CLINKX_WORKFLOWS_STATE_DIR: profile.roots.state,
56
+ CLINKX_CONTEXT_BUILDER_RUNS_DIR: profile.roots.contextRuns,
57
+ CLINKX_WORKFLOWS_WORKSPACE_ROOT: profile.roots.workspace,
58
+ CLINKX_SETTINGS_DIR: profile.roots.settings,
59
+ CLINKX_WORKFLOWS_DASHBOARD_CREDENTIAL_DIR: profile.roots.credentials,
60
+ CLINKX_WORKFLOWS_PROGRESS_REPORT_OVERRIDE_DIR: profile.roots.binding,
61
+ });
62
+ if (profile.roots.adapters !== undefined)
63
+ env["CLINKX_CONFIG_PATH"] = profile.roots.adapters;
64
+ return env;
65
+ }
66
+ /** Arguments for a supervised start; the listener port is ephemeral because only the gateway tunnel reaches it. */
67
+ export function buildCompanionArguments(profile) {
68
+ return ["--host-managed", "--port", "0", "--credential-expectation", profile.credentialExpectation];
69
+ }
70
+ //# sourceMappingURL=child-env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"child-env.js","sourceRoot":"","sources":["../../src/desktop-host/child-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGlE,4FAA4F;AAC5F,MAAM,gBAAgB,GAAG;IACvB,YAAY;IACZ,QAAQ;IACR,aAAa;IACb,aAAa;IACb,SAAS;IACT,cAAc;IACd,aAAa;IACb,MAAM;IACN,KAAK;CACG,CAAC;AAEX,oGAAoG;AACpG,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAU,CAAC;AAErE,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,IAAuC;IAC1F,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAChF,CAAC;AAaD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAgC;IACxE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;YAC/B,CAAC,CAAC,8EAA8E;YAChF,CAAC,CAAC,qEAAqE,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC;IAC9D,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO;QAAE,GAAG,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;;QAC3D,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAElC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QACjB,oCAAoC,EAAE,SAAS;QAC/C,4CAA4C,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QACpE,oCAAoC,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QAC5D,4BAA4B,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;QACxD,8BAA8B,EAAE,KAAK,CAAC,cAAc;QACpD,0BAA0B,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QAC/C,+BAA+B,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW;QAC1D,+BAA+B,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS;QACxD,mBAAmB,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;QAC3C,yCAAyC,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW;QACpE,6CAA6C,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;KACrE,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,OAAO,CAAC,gBAAgB,EAAE,QAAQ,EAAE,GAAG,EAAE,0BAA0B,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;AACtG,CAAC"}
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
@@ -0,0 +1,50 @@
1
+ #!/usr/bin/env node
2
+ import { writeSync } from "node:fs";
3
+ import { isAbsolute, resolve } from "node:path";
4
+ import { DesktopDaemon, DESKTOP_APP_DATA_ENV } from "./daemon.js";
5
+ import { daemonFatalMessage } from "./daemon.js";
6
+ import { DESKTOP_SERVICE_ENV, HOME, TMPDIR, serviceFromEnv } from "./daemon-env.js";
7
+ // A supervising shell can only quote stderr: an unwritten crash is invisible.
8
+ // These last words are one bounded line each, then a definite exit.
9
+ process.on("uncaughtException", (error) => {
10
+ writeSync(2, `host daemon: uncaught ${daemonFatalMessage(error)}\n`);
11
+ process.exit(1);
12
+ });
13
+ process.on("unhandledRejection", (reason) => {
14
+ writeSync(2, `host daemon: unhandled rejection ${daemonFatalMessage(reason)}\n`);
15
+ process.exit(1);
16
+ });
17
+ // --host-daemon [--app-data <dir>]: run as the supervising host instead of the
18
+ // dashboard companion. The thin shell spawns this mode with the keychain-held
19
+ // workstation key in the environment and exchanges daemon requests over stdio.
20
+ async function main() {
21
+ const appDataIndex = process.argv.indexOf("--app-data");
22
+ const appDataArgument = appDataIndex === -1 ? undefined : process.argv[appDataIndex + 1];
23
+ if (appDataIndex !== -1 && (appDataArgument == null || appDataArgument.startsWith("--"))) {
24
+ throw new Error("--app-data requires a path");
25
+ }
26
+ const configured = appDataArgument ?? process.env[DESKTOP_APP_DATA_ENV];
27
+ if (configured == null || configured === "" || !isAbsolute(resolve(configured))) {
28
+ throw new Error(`an absolute app-data directory is required (--app-data or ${DESKTOP_APP_DATA_ENV})`);
29
+ }
30
+ const service = serviceFromEnv(process.env[DESKTOP_SERVICE_ENV]);
31
+ await new DesktopDaemon({
32
+ appData: resolve(configured),
33
+ home: HOME(),
34
+ tmpdir: TMPDIR(),
35
+ platform: process.platform,
36
+ ambient: process.env,
37
+ ...(service === undefined ? {} : { service }),
38
+ // Development shells and tests point the daemon at another companion
39
+ // executable (for example a fake); production leaves it unset and the
40
+ // daemon supervises a child of itself.
41
+ ...(process.env["CLINKX_DESKTOP_COMPANION_EXECUTABLE"] === undefined
42
+ ? {}
43
+ : { companionOverride: { executable: resolve(process.env["CLINKX_DESKTOP_COMPANION_EXECUTABLE"]) } }),
44
+ }).run();
45
+ }
46
+ main().catch((error) => {
47
+ process.stderr.write(`host daemon: ${daemonFatalMessage(error)}\n`);
48
+ process.exitCode = 1;
49
+ });
50
+ //# sourceMappingURL=daemon-entry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-entry.js","sourceRoot":"","sources":["../../src/desktop-host/daemon-entry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { DesktopService } from "./profile.js";
2
+ /** Set by the shell when this build targets a self-hosted gateway instead of the hosted service. */
3
+ export declare const DESKTOP_SERVICE_ENV = "CLINKX_DESKTOP_SERVICE";
4
+ /** `origin|gatewayUrl|mode`, strictly parsed; anything malformed is refused, never guessed. */
5
+ export declare function serviceFromEnv(raw: string | undefined): DesktopService | undefined;
6
+ /**
7
+ * The daemon's view of the user's home. It must not inherit a stale HOME from
8
+ * the shell process: companion roots and Settings resolution key off it, so a
9
+ * GUI-launched process with a scrubbed environment still finds the real user.
10
+ */
11
+ export declare function HOME(): string;
12
+ export declare function TMPDIR(): string;
@@ -0,0 +1,35 @@
1
+ import { homedir, tmpdir } from "node:os";
2
+ /** Set by the shell when this build targets a self-hosted gateway instead of the hosted service. */
3
+ export const DESKTOP_SERVICE_ENV = "CLINKX_DESKTOP_SERVICE";
4
+ /** `origin|gatewayUrl|mode`, strictly parsed; anything malformed is refused, never guessed. */
5
+ export function serviceFromEnv(raw) {
6
+ if (raw === undefined || raw === "")
7
+ return undefined;
8
+ const parts = raw.split("|");
9
+ if (parts.length !== 3)
10
+ throw new Error(`${DESKTOP_SERVICE_ENV} must be origin|gatewayUrl|mode`);
11
+ const [origin, gatewayUrl, mode] = parts;
12
+ if (mode !== "tenant" && mode !== "legacy") {
13
+ throw new Error(`${DESKTOP_SERVICE_ENV} mode must be tenant or legacy`);
14
+ }
15
+ for (const value of [origin, gatewayUrl]) {
16
+ if (value === "")
17
+ throw new Error(`${DESKTOP_SERVICE_ENV} origin and gateway URL are required`);
18
+ }
19
+ return { origin, gatewayUrl, mode };
20
+ }
21
+ /**
22
+ * The daemon's view of the user's home. It must not inherit a stale HOME from
23
+ * the shell process: companion roots and Settings resolution key off it, so a
24
+ * GUI-launched process with a scrubbed environment still finds the real user.
25
+ */
26
+ export function HOME() {
27
+ const explicit = process.env["HOME"];
28
+ if (explicit !== undefined && explicit !== "")
29
+ return explicit;
30
+ return homedir();
31
+ }
32
+ export function TMPDIR() {
33
+ return tmpdir();
34
+ }
35
+ //# sourceMappingURL=daemon-env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-env.js","sourceRoot":"","sources":["../../src/desktop-host/daemon-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAI1C,oGAAoG;AACpG,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAE5D,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,GAAuB;IACpD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,iCAAiC,CAAC,CAAC;IACjG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,KAAiC,CAAC;IACrE,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,gCAAgC,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;QACzC,IAAI,KAAK,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,sCAAsC,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/D,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC"}