clinkx 1.3.0 → 1.4.1

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 (179) hide show
  1. package/CHANGELOG.md +57 -0
  2. package/README.md +13 -6
  3. package/clinkx-workflows/dist/child-env.d.ts +3 -0
  4. package/clinkx-workflows/dist/child-env.js +11 -0
  5. package/clinkx-workflows/dist/child-env.js.map +1 -1
  6. package/clinkx-workflows/dist/dashboard/api-routes.d.ts +21 -0
  7. package/clinkx-workflows/dist/dashboard/api-routes.js +27 -0
  8. package/clinkx-workflows/dist/dashboard/api-routes.js.map +1 -1
  9. package/clinkx-workflows/dist/dashboard/auth/challenge-store.d.ts +13 -0
  10. package/clinkx-workflows/dist/dashboard/auth/challenge-store.js.map +1 -1
  11. package/clinkx-workflows/dist/dashboard/auth/controller.d.ts +27 -0
  12. package/clinkx-workflows/dist/dashboard/auth/controller.js +262 -23
  13. package/clinkx-workflows/dist/dashboard/auth/controller.js.map +1 -1
  14. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.d.ts +62 -0
  15. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js +70 -0
  16. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js.map +1 -0
  17. package/clinkx-workflows/dist/dashboard/request-admission.d.ts +6 -0
  18. package/clinkx-workflows/dist/dashboard/request-admission.js +9 -0
  19. package/clinkx-workflows/dist/dashboard/request-admission.js.map +1 -1
  20. package/clinkx-workflows/dist/dashboard/server-factory.js +15 -1
  21. package/clinkx-workflows/dist/dashboard/server-factory.js.map +1 -1
  22. package/clinkx-workflows/dist/dashboard/settings-contract.d.ts +1806 -0
  23. package/clinkx-workflows/dist/dashboard/settings-contract.js +630 -0
  24. package/clinkx-workflows/dist/dashboard/settings-contract.js.map +1 -0
  25. package/clinkx-workflows/dist/dashboard/settings-process-reader.d.ts +48 -0
  26. package/clinkx-workflows/dist/dashboard/settings-process-reader.js +195 -0
  27. package/clinkx-workflows/dist/dashboard/settings-process-reader.js.map +1 -0
  28. package/clinkx-workflows/dist/dashboard/settings-routes.d.ts +87 -0
  29. package/clinkx-workflows/dist/dashboard/settings-routes.js +690 -0
  30. package/clinkx-workflows/dist/dashboard/settings-routes.js.map +1 -0
  31. package/clinkx-workflows/dist/dashboard-ui/assets/index-CX4FrhYN.js +122 -0
  32. package/clinkx-workflows/dist/dashboard-ui/assets/style-C5guUjwN.css +1 -0
  33. package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
  34. package/clinkx-workflows/dist/durable-file-core.d.ts +76 -0
  35. package/clinkx-workflows/dist/durable-file-core.js +146 -0
  36. package/clinkx-workflows/dist/durable-file-core.js.map +1 -0
  37. package/clinkx-workflows/dist/durable-file.d.ts +8 -64
  38. package/clinkx-workflows/dist/durable-file.js +14 -137
  39. package/clinkx-workflows/dist/durable-file.js.map +1 -1
  40. package/clinkx-workflows/dist/index.js +68 -2
  41. package/clinkx-workflows/dist/index.js.map +1 -1
  42. package/clinkx-workflows/dist/settings/audit.d.ts +101 -0
  43. package/clinkx-workflows/dist/settings/audit.js +318 -0
  44. package/clinkx-workflows/dist/settings/audit.js.map +1 -0
  45. package/clinkx-workflows/dist/settings/bootstrap.d.ts +35 -0
  46. package/clinkx-workflows/dist/settings/bootstrap.js +52 -0
  47. package/clinkx-workflows/dist/settings/bootstrap.js.map +1 -0
  48. package/clinkx-workflows/dist/settings/codec.d.ts +51 -0
  49. package/clinkx-workflows/dist/settings/codec.js +410 -0
  50. package/clinkx-workflows/dist/settings/codec.js.map +1 -0
  51. package/clinkx-workflows/dist/settings/durable-write.d.ts +48 -0
  52. package/clinkx-workflows/dist/settings/durable-write.js +31 -0
  53. package/clinkx-workflows/dist/settings/durable-write.js.map +1 -0
  54. package/clinkx-workflows/dist/settings/index.d.ts +20 -0
  55. package/clinkx-workflows/dist/settings/index.js +23 -0
  56. package/clinkx-workflows/dist/settings/index.js.map +1 -0
  57. package/clinkx-workflows/dist/settings/loader.d.ts +80 -0
  58. package/clinkx-workflows/dist/settings/loader.js +577 -0
  59. package/clinkx-workflows/dist/settings/loader.js.map +1 -0
  60. package/clinkx-workflows/dist/settings/lock.d.ts +108 -0
  61. package/clinkx-workflows/dist/settings/lock.js +344 -0
  62. package/clinkx-workflows/dist/settings/lock.js.map +1 -0
  63. package/clinkx-workflows/dist/settings/paths.d.ts +65 -0
  64. package/clinkx-workflows/dist/settings/paths.js +173 -0
  65. package/clinkx-workflows/dist/settings/paths.js.map +1 -0
  66. package/clinkx-workflows/dist/settings/process-heartbeat.d.ts +47 -0
  67. package/clinkx-workflows/dist/settings/process-heartbeat.js +305 -0
  68. package/clinkx-workflows/dist/settings/process-heartbeat.js.map +1 -0
  69. package/clinkx-workflows/dist/settings/registry.d.ts +178 -0
  70. package/clinkx-workflows/dist/settings/registry.js +1290 -0
  71. package/clinkx-workflows/dist/settings/registry.js.map +1 -0
  72. package/clinkx-workflows/dist/settings/schema.d.ts +404 -0
  73. package/clinkx-workflows/dist/settings/schema.js +415 -0
  74. package/clinkx-workflows/dist/settings/schema.js.map +1 -0
  75. package/clinkx-workflows/dist/settings/store.d.ts +157 -0
  76. package/clinkx-workflows/dist/settings/store.js +842 -0
  77. package/clinkx-workflows/dist/settings/store.js.map +1 -0
  78. package/clinkx-workflows/dist/stdio-entry.d.ts +2 -0
  79. package/clinkx-workflows/dist/stdio-entry.js +52 -0
  80. package/clinkx-workflows/dist/stdio-entry.js.map +1 -0
  81. package/dist/dashboard-cli.d.ts +11 -3
  82. package/dist/dashboard-cli.js +199 -33
  83. package/dist/dashboard-cli.js.map +1 -1
  84. package/dist/dashboard-companion/client.d.ts +14 -0
  85. package/dist/dashboard-companion/client.js +16 -0
  86. package/dist/dashboard-companion/client.js.map +1 -1
  87. package/dist/dashboard-companion/credential-expectation.d.ts +23 -0
  88. package/dist/dashboard-companion/credential-expectation.js +50 -0
  89. package/dist/dashboard-companion/credential-expectation.js.map +1 -0
  90. package/dist/dashboard-companion/host-channel.d.ts +36 -0
  91. package/dist/dashboard-companion/host-channel.js +78 -0
  92. package/dist/dashboard-companion/host-channel.js.map +1 -0
  93. package/dist/dashboard-companion/host-status.d.ts +179 -0
  94. package/dist/dashboard-companion/host-status.js +122 -0
  95. package/dist/dashboard-companion/host-status.js.map +1 -0
  96. package/dist/dashboard-companion/protocol.js +17 -0
  97. package/dist/dashboard-companion/protocol.js.map +1 -1
  98. package/dist/dashboard-companion/standalone-assets.d.ts +8 -0
  99. package/dist/dashboard-companion/standalone-assets.js +7 -1
  100. package/dist/dashboard-companion/standalone-assets.js.map +1 -1
  101. package/dist/dashboard-companion/standalone-entry.js +34 -13
  102. package/dist/dashboard-companion/standalone-entry.js.map +1 -1
  103. package/dist/dashboard-gateway/control-plane/contracts.d.ts +38 -38
  104. package/dist/dashboard-gateway/tunnel-http.js +20 -0
  105. package/dist/dashboard-gateway/tunnel-http.js.map +1 -1
  106. package/dist/desktop-host/child-env.d.ts +23 -0
  107. package/dist/desktop-host/child-env.js +70 -0
  108. package/dist/desktop-host/child-env.js.map +1 -0
  109. package/dist/desktop-host/daemon-entry.d.ts +2 -0
  110. package/dist/desktop-host/daemon-entry.js +50 -0
  111. package/dist/desktop-host/daemon-entry.js.map +1 -0
  112. package/dist/desktop-host/daemon-env.d.ts +12 -0
  113. package/dist/desktop-host/daemon-env.js +35 -0
  114. package/dist/desktop-host/daemon-env.js.map +1 -0
  115. package/dist/desktop-host/daemon-protocol.d.ts +210 -0
  116. package/dist/desktop-host/daemon-protocol.js +56 -0
  117. package/dist/desktop-host/daemon-protocol.js.map +1 -0
  118. package/dist/desktop-host/daemon.d.ts +50 -0
  119. package/dist/desktop-host/daemon.js +441 -0
  120. package/dist/desktop-host/daemon.js.map +1 -0
  121. package/dist/desktop-host/enrollment.d.ts +17 -0
  122. package/dist/desktop-host/enrollment.js +25 -0
  123. package/dist/desktop-host/enrollment.js.map +1 -0
  124. package/dist/desktop-host/import.d.ts +14 -0
  125. package/dist/desktop-host/import.js +95 -0
  126. package/dist/desktop-host/import.js.map +1 -0
  127. package/dist/desktop-host/profile.d.ts +130 -0
  128. package/dist/desktop-host/profile.js +176 -0
  129. package/dist/desktop-host/profile.js.map +1 -0
  130. package/dist/desktop-host/service.d.ts +6 -0
  131. package/dist/desktop-host/service.js +7 -0
  132. package/dist/desktop-host/service.js.map +1 -0
  133. package/dist/desktop-host/supervisor.d.ts +57 -0
  134. package/dist/desktop-host/supervisor.js +256 -0
  135. package/dist/desktop-host/supervisor.js.map +1 -0
  136. package/dist/desktop-host/view-state.d.ts +138 -0
  137. package/dist/desktop-host/view-state.js +27 -0
  138. package/dist/desktop-host/view-state.js.map +1 -0
  139. package/dist/elaris/config.d.ts +10 -0
  140. package/dist/elaris/config.js +27 -1
  141. package/dist/elaris/config.js.map +1 -1
  142. package/dist/elaris/tools.js +4 -1
  143. package/dist/elaris/tools.js.map +1 -1
  144. package/dist/index.d.ts +0 -31
  145. package/dist/index.js +41 -404
  146. package/dist/index.js.map +1 -1
  147. package/dist/lib.d.ts +17 -0
  148. package/dist/lib.js +17 -0
  149. package/dist/lib.js.map +1 -0
  150. package/dist/progress-report/lock.d.ts +17 -59
  151. package/dist/progress-report/lock.js +25 -329
  152. package/dist/progress-report/lock.js.map +1 -1
  153. package/dist/registry.d.ts +7 -0
  154. package/dist/registry.js +21 -7
  155. package/dist/registry.js.map +1 -1
  156. package/dist/server.js +75 -4
  157. package/dist/server.js.map +1 -1
  158. package/dist/settings-cli/clients.d.ts +137 -0
  159. package/dist/settings-cli/clients.js +1124 -0
  160. package/dist/settings-cli/clients.js.map +1 -0
  161. package/dist/settings-cli/commands.d.ts +67 -0
  162. package/dist/settings-cli/commands.js +726 -0
  163. package/dist/settings-cli/commands.js.map +1 -0
  164. package/dist/settings-cli/format.d.ts +34 -0
  165. package/dist/settings-cli/format.js +40 -0
  166. package/dist/settings-cli/format.js.map +1 -0
  167. package/dist/settings-cli/main.d.ts +18 -0
  168. package/dist/settings-cli/main.js +256 -0
  169. package/dist/settings-cli/main.js.map +1 -0
  170. package/dist/stdio-main.d.ts +73 -0
  171. package/dist/stdio-main.js +455 -0
  172. package/dist/stdio-main.js.map +1 -0
  173. package/docs/configuration.md +340 -39
  174. package/docs/security.md +150 -6
  175. package/docs/verification/README.md +28 -2
  176. package/docs/verification/workflow-handoff.md +86 -0
  177. package/package.json +3 -3
  178. package/clinkx-workflows/dist/dashboard-ui/assets/index-DRId2DVA.js +0 -119
  179. package/clinkx-workflows/dist/dashboard-ui/assets/style-CHAw57y5.css +0 -1
@@ -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"}
@@ -0,0 +1,210 @@
1
+ import { z } from "zod";
2
+ import { type DaemonOp } from "./view-state.js";
3
+ export declare const DaemonRequestSchema: z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
4
+ id: z.ZodString;
5
+ op: z.ZodLiteral<"get-state">;
6
+ }, "strip", z.ZodTypeAny, {
7
+ op: "get-state";
8
+ id: string;
9
+ }, {
10
+ op: "get-state";
11
+ id: string;
12
+ }>, z.ZodObject<{
13
+ id: z.ZodString;
14
+ op: z.ZodLiteral<"save-setup">;
15
+ input: z.ZodObject<{
16
+ workstationKey: z.ZodOptional<z.ZodString>;
17
+ roots: z.ZodObject<{
18
+ state: z.ZodString;
19
+ contextRuns: z.ZodString;
20
+ workspace: z.ZodString;
21
+ settings: z.ZodString;
22
+ }, "strict", z.ZodTypeAny, {
23
+ state: string;
24
+ settings: string;
25
+ contextRuns: string;
26
+ workspace: string;
27
+ }, {
28
+ state: string;
29
+ settings: string;
30
+ contextRuns: string;
31
+ workspace: string;
32
+ }>;
33
+ lifecycle: z.ZodObject<{
34
+ keepRunningInBackground: z.ZodBoolean;
35
+ startAtLogin: z.ZodBoolean;
36
+ }, "strict", z.ZodTypeAny, {
37
+ keepRunningInBackground: boolean;
38
+ startAtLogin: boolean;
39
+ }, {
40
+ keepRunningInBackground: boolean;
41
+ startAtLogin: boolean;
42
+ }>;
43
+ service: z.ZodOptional<z.ZodObject<{
44
+ origin: z.ZodString;
45
+ gatewayUrl: z.ZodString;
46
+ mode: z.ZodEnum<["tenant", "legacy"]>;
47
+ }, "strict", z.ZodTypeAny, {
48
+ mode: "legacy" | "tenant";
49
+ origin: string;
50
+ gatewayUrl: string;
51
+ }, {
52
+ mode: "legacy" | "tenant";
53
+ origin: string;
54
+ gatewayUrl: string;
55
+ }>>;
56
+ createMissingFolders: z.ZodBoolean;
57
+ importFrom: z.ZodOptional<z.ZodString>;
58
+ }, "strict", z.ZodTypeAny, {
59
+ roots: {
60
+ state: string;
61
+ settings: string;
62
+ contextRuns: string;
63
+ workspace: string;
64
+ };
65
+ lifecycle: {
66
+ keepRunningInBackground: boolean;
67
+ startAtLogin: boolean;
68
+ };
69
+ createMissingFolders: boolean;
70
+ service?: {
71
+ mode: "legacy" | "tenant";
72
+ origin: string;
73
+ gatewayUrl: string;
74
+ } | undefined;
75
+ workstationKey?: string | undefined;
76
+ importFrom?: string | undefined;
77
+ }, {
78
+ roots: {
79
+ state: string;
80
+ settings: string;
81
+ contextRuns: string;
82
+ workspace: string;
83
+ };
84
+ lifecycle: {
85
+ keepRunningInBackground: boolean;
86
+ startAtLogin: boolean;
87
+ };
88
+ createMissingFolders: boolean;
89
+ service?: {
90
+ mode: "legacy" | "tenant";
91
+ origin: string;
92
+ gatewayUrl: string;
93
+ } | undefined;
94
+ workstationKey?: string | undefined;
95
+ importFrom?: string | undefined;
96
+ }>;
97
+ }, "strip", z.ZodTypeAny, {
98
+ op: "save-setup";
99
+ id: string;
100
+ input: {
101
+ roots: {
102
+ state: string;
103
+ settings: string;
104
+ contextRuns: string;
105
+ workspace: string;
106
+ };
107
+ lifecycle: {
108
+ keepRunningInBackground: boolean;
109
+ startAtLogin: boolean;
110
+ };
111
+ createMissingFolders: boolean;
112
+ service?: {
113
+ mode: "legacy" | "tenant";
114
+ origin: string;
115
+ gatewayUrl: string;
116
+ } | undefined;
117
+ workstationKey?: string | undefined;
118
+ importFrom?: string | undefined;
119
+ };
120
+ }, {
121
+ op: "save-setup";
122
+ id: string;
123
+ input: {
124
+ roots: {
125
+ state: string;
126
+ settings: string;
127
+ contextRuns: string;
128
+ workspace: string;
129
+ };
130
+ lifecycle: {
131
+ keepRunningInBackground: boolean;
132
+ startAtLogin: boolean;
133
+ };
134
+ createMissingFolders: boolean;
135
+ service?: {
136
+ mode: "legacy" | "tenant";
137
+ origin: string;
138
+ gatewayUrl: string;
139
+ } | undefined;
140
+ workstationKey?: string | undefined;
141
+ importFrom?: string | undefined;
142
+ };
143
+ }>, z.ZodObject<{
144
+ id: z.ZodString;
145
+ op: z.ZodLiteral<"connect">;
146
+ }, "strip", z.ZodTypeAny, {
147
+ op: "connect";
148
+ id: string;
149
+ }, {
150
+ op: "connect";
151
+ id: string;
152
+ }>, z.ZodObject<{
153
+ id: z.ZodString;
154
+ op: z.ZodLiteral<"disconnect">;
155
+ }, "strip", z.ZodTypeAny, {
156
+ op: "disconnect";
157
+ id: string;
158
+ }, {
159
+ op: "disconnect";
160
+ id: string;
161
+ }>, z.ZodObject<{
162
+ id: z.ZodString;
163
+ op: z.ZodLiteral<"recover">;
164
+ action: z.ZodEnum<["new-enrollment", "reset-binding"]>;
165
+ }, "strip", z.ZodTypeAny, {
166
+ op: "recover";
167
+ id: string;
168
+ action: "new-enrollment" | "reset-binding";
169
+ }, {
170
+ op: "recover";
171
+ id: string;
172
+ action: "new-enrollment" | "reset-binding";
173
+ }>, z.ZodObject<{
174
+ id: z.ZodString;
175
+ op: z.ZodLiteral<"diagnostics">;
176
+ }, "strip", z.ZodTypeAny, {
177
+ op: "diagnostics";
178
+ id: string;
179
+ }, {
180
+ op: "diagnostics";
181
+ id: string;
182
+ }>, z.ZodObject<{
183
+ id: z.ZodString;
184
+ op: z.ZodLiteral<"shutdown">;
185
+ }, "strip", z.ZodTypeAny, {
186
+ op: "shutdown";
187
+ id: string;
188
+ }, {
189
+ op: "shutdown";
190
+ id: string;
191
+ }>, z.ZodObject<{
192
+ op: z.ZodLiteral<"key-stored">;
193
+ ok: z.ZodBoolean;
194
+ error: z.ZodOptional<z.ZodString>;
195
+ }, "strip", z.ZodTypeAny, {
196
+ op: "key-stored";
197
+ ok: boolean;
198
+ error?: string | undefined;
199
+ }, {
200
+ op: "key-stored";
201
+ ok: boolean;
202
+ error?: string | undefined;
203
+ }>]>;
204
+ export type DaemonRequest = z.infer<typeof DaemonRequestSchema>;
205
+ export type DaemonRequestWithId = Extract<DaemonRequest, {
206
+ id: string;
207
+ }>;
208
+ export declare function formatDaemonRequest(request: DaemonRequest): string;
209
+ export declare function parseDaemonRequestLine(line: string): DaemonRequest;
210
+ export declare function isDaemonOp(value: string): value is DaemonOp;
@@ -0,0 +1,56 @@
1
+ import { z } from "zod";
2
+ import { DAEMON_OPS, SetupInputSchema } from "./view-state.js";
3
+ import { HostStatusProtocolError, MAX_HOST_STATUS_LINE_BYTES } from "../dashboard-companion/host-status.js";
4
+ /**
5
+ * Requests a supervising shell sends to the host daemon over its stdin: one
6
+ * JSON object per line, answered on stdout by a `response` event (same id)
7
+ * plus `state` pushes whenever anything changes. The daemon and its shell
8
+ * ship as a pair; unknown ops fail with a machine-readable error instead of
9
+ * being ignored.
10
+ */
11
+ const op = z.enum(DAEMON_OPS);
12
+ export const DaemonRequestSchema = z.discriminatedUnion("op", [
13
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("get-state") }),
14
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("save-setup"), input: SetupInputSchema }),
15
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("connect") }),
16
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("disconnect") }),
17
+ z.object({
18
+ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
19
+ op: z.literal("recover"),
20
+ action: z.enum(["new-enrollment", "reset-binding"]),
21
+ }),
22
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("diagnostics") }),
23
+ z.object({ id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/), op: z.literal("shutdown") }),
24
+ z.object({ op: z.literal("key-stored"), ok: z.boolean(), error: z.string().max(1_000).optional() }),
25
+ ]);
26
+ export function formatDaemonRequest(request) {
27
+ const line = `${JSON.stringify(DaemonRequestSchema.parse(request))}\n`;
28
+ if (Buffer.byteLength(line) > MAX_HOST_STATUS_LINE_BYTES) {
29
+ throw new HostStatusProtocolError("daemon request exceeds the size limit");
30
+ }
31
+ return line;
32
+ }
33
+ export function parseDaemonRequestLine(line) {
34
+ if (Buffer.byteLength(line) > MAX_HOST_STATUS_LINE_BYTES) {
35
+ throw new HostStatusProtocolError("daemon request line exceeds the size limit");
36
+ }
37
+ let value;
38
+ try {
39
+ value = JSON.parse(line);
40
+ }
41
+ catch {
42
+ throw new HostStatusProtocolError("daemon request line is not JSON");
43
+ }
44
+ const parsed = DaemonRequestSchema.safeParse(value);
45
+ if (!parsed.success) {
46
+ const attempted = typeof value?.op === "string"
47
+ ? value.op
48
+ : "unknown";
49
+ throw new HostStatusProtocolError(`invalid daemon request (${attempted})`);
50
+ }
51
+ return parsed.data;
52
+ }
53
+ export function isDaemonOp(value) {
54
+ return DAEMON_OPS.includes(value);
55
+ }
56
+ //# sourceMappingURL=daemon-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-protocol.js","sourceRoot":"","sources":["../../src/desktop-host/daemon-protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ import { type DesktopService } from "./profile.js";
2
+ import { type DesktopViewState, type RecoveryAction } from "./view-state.js";
3
+ /** Where the shell puts the keychain-held key and the app-data location. */
4
+ export declare const DESKTOP_KEY_ENV = "CLINKX_DESKTOP_WORKSTATION_KEY";
5
+ export declare const DESKTOP_APP_DATA_ENV = "CLINKX_DESKTOP_APP_DATA";
6
+ export declare const DESKTOP_VAULT_ENV = "CLINKX_DESKTOP_VAULT";
7
+ export interface DesktopDaemonIo {
8
+ readonly stdin: NodeJS.ReadableStream;
9
+ readonly stdout: NodeJS.WritableStream;
10
+ }
11
+ export interface DesktopDaemonOptions {
12
+ readonly appData: string;
13
+ readonly home: string;
14
+ readonly tmpdir: string;
15
+ readonly platform: NodeJS.Platform;
16
+ readonly ambient: NodeJS.ProcessEnv;
17
+ readonly service?: DesktopService;
18
+ readonly companionOverride?: {
19
+ readonly executable: string;
20
+ readonly prefixArgs?: readonly string[];
21
+ };
22
+ readonly enrollmentPollMs?: number;
23
+ readonly stopTimeoutMs?: number;
24
+ readonly io?: DesktopDaemonIo;
25
+ }
26
+ /**
27
+ * The host daemon: the Electron-free controller from the first launcher
28
+ * release, now running inside the companion executable itself. A thin shell
29
+ * (Tauri) spawns this process with `--host-daemon`, holds the workstation key
30
+ * in the OS keychain, and exchanges newline-delimited JSON: requests on the
31
+ * daemon's stdin, `state`/`response` events on its stdout. One binary plays
32
+ * both roles — this process supervises a child of itself running the
33
+ * dashboard companion.
34
+ */
35
+ export declare class DesktopDaemon {
36
+ #private;
37
+ constructor(options: DesktopDaemonOptions);
38
+ /** Serve requests until a shutdown request (or stdin EOF) completes. */
39
+ run(): Promise<void>;
40
+ state(): DesktopViewState;
41
+ enrollmentCode(): string | undefined;
42
+ startCompanion(): Promise<void>;
43
+ stopCompanion(): Promise<void>;
44
+ saveSetup(raw: unknown): Promise<void>;
45
+ recover(action: RecoveryAction): Promise<void>;
46
+ diagnostics(): string;
47
+ /** Stop and wait, completing the companion's cleanup before the daemon exits. */
48
+ shutdown(): Promise<void>;
49
+ }
50
+ export declare function daemonFatalMessage(error: unknown): string;