clinkx 1.1.2 → 1.2.0

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 (56) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +63 -12
  3. package/clinkx-workflows/dist/allowed-roots.js +2 -0
  4. package/clinkx-workflows/dist/allowed-roots.js.map +1 -1
  5. package/clinkx-workflows/dist/child-env.d.ts +3 -1
  6. package/clinkx-workflows/dist/child-env.js +6 -2
  7. package/clinkx-workflows/dist/child-env.js.map +1 -1
  8. package/clinkx-workflows/dist/config.d.ts +28 -5
  9. package/clinkx-workflows/dist/config.js +137 -20
  10. package/clinkx-workflows/dist/config.js.map +1 -1
  11. package/clinkx-workflows/dist/contained-file.js +9 -0
  12. package/clinkx-workflows/dist/contained-file.js.map +1 -1
  13. package/clinkx-workflows/dist/dashboard/session-log-identity.js +2 -1
  14. package/clinkx-workflows/dist/dashboard/session-log-identity.js.map +1 -1
  15. package/clinkx-workflows/dist/root-path-validation.d.ts +12 -0
  16. package/clinkx-workflows/dist/root-path-validation.js +63 -0
  17. package/clinkx-workflows/dist/root-path-validation.js.map +1 -0
  18. package/clinkx-workflows/dist/rosters.d.ts +1 -0
  19. package/clinkx-workflows/dist/rosters.js +16 -6
  20. package/clinkx-workflows/dist/rosters.js.map +1 -1
  21. package/clinkx-workflows/dist/server.js +5 -2
  22. package/clinkx-workflows/dist/server.js.map +1 -1
  23. package/clinkx-workflows/dist/state-schema.d.ts +13 -0
  24. package/clinkx-workflows/dist/state.d.ts +7 -1
  25. package/clinkx-workflows/dist/state.js +74 -13
  26. package/clinkx-workflows/dist/state.js.map +1 -1
  27. package/clinkx-workflows/dist/workflow-completion.d.ts +83 -0
  28. package/clinkx-workflows/dist/workflow-completion.js +250 -0
  29. package/clinkx-workflows/dist/workflow-completion.js.map +1 -0
  30. package/clinkx-workflows/dist/workflow-tools.d.ts +4 -3
  31. package/clinkx-workflows/dist/workflow-tools.js +341 -34
  32. package/clinkx-workflows/dist/workflow-tools.js.map +1 -1
  33. package/dist/allowed-roots.d.ts +1 -1
  34. package/dist/allowed-roots.js +124 -14
  35. package/dist/allowed-roots.js.map +1 -1
  36. package/dist/context-builder/config.d.ts +1 -0
  37. package/dist/context-builder/config.js +21 -9
  38. package/dist/context-builder/config.js.map +1 -1
  39. package/dist/context-builder/mutation-lock.d.ts +4 -0
  40. package/dist/context-builder/mutation-lock.js +7 -1
  41. package/dist/context-builder/mutation-lock.js.map +1 -1
  42. package/dist/context-builder/storage.d.ts +10 -2
  43. package/dist/context-builder/storage.js +213 -16
  44. package/dist/context-builder/storage.js.map +1 -1
  45. package/dist/dashboard-cli.d.ts +6 -0
  46. package/dist/dashboard-cli.js +8 -29
  47. package/dist/dashboard-cli.js.map +1 -1
  48. package/dist/registry.d.ts +1 -1
  49. package/dist/registry.js +5 -1
  50. package/dist/registry.js.map +1 -1
  51. package/dist/server.js +12 -5
  52. package/dist/server.js.map +1 -1
  53. package/docs/configuration.md +157 -12
  54. package/docs/security.md +3 -0
  55. package/package.json +1 -1
  56. package/scripts/provider-doctor-core.mjs +21 -5
@@ -31,6 +31,7 @@ async function loadModules(withProbe) {
31
31
  redactSecrets: env.redactSecrets,
32
32
  redactCredentials: (text) => redaction.redactWithOptions(text, {}),
33
33
  preflightEnabled: () => process.env["CLINKX_WORKFLOWS_CONTEXT_PREFLIGHT_ENABLED"]?.trim().toLowerCase() !== "false",
34
+ getClinkxHome: workflowsConfig.getClinkxHome,
34
35
  getChildConfigPath: workflowsConfig.getChildConfigPath,
35
36
  getDefaultCurator: workflowsConfig.getWorkflowsContextDefaultCurator,
36
37
  getContextDefault: workflowsConfig.getWorkflowsContextDefault,
@@ -242,13 +243,28 @@ function configFiles(path) {
242
243
  }
243
244
  }
244
245
 
245
- function standardConfigFiles() {
246
+ function jsonFilesInDirectory(dir) {
247
+ if (!existsSync(dir)) return [];
248
+ try {
249
+ return readdirSync(dir).filter((file) => file.endsWith(".json")).sort().map((file) => join(dir, file));
250
+ } catch {
251
+ return [];
252
+ }
253
+ }
254
+
255
+ // Mirrors discoverConfigPaths() in src/registry.ts; a CLINKX_HOME error has already failed AdapterRegistry.load() with its own message.
256
+ function standardConfigFiles(getClinkxHome) {
246
257
  const envPath = process.env["CLINKX_CONFIG_PATH"];
247
258
  if (envPath != null && envPath !== "") return configFiles(envPath);
248
259
  const xdgHome = process.env["XDG_CONFIG_HOME"] ?? join(homedir(), ".config");
249
- return [join(xdgHome, "clinkx", "adapters"), join(PACKAGE_ROOT, "conf", "adapters")]
250
- .filter((dir) => existsSync(dir))
251
- .flatMap(configFiles);
260
+ let homeTier = [];
261
+ try {
262
+ homeTier = [join(getClinkxHome(), "adapters")];
263
+ } catch {
264
+ homeTier = [];
265
+ }
266
+ return [...homeTier, join(xdgHome, "clinkx", "adapters"), join(PACKAGE_ROOT, "conf", "adapters")]
267
+ .flatMap(jsonFilesInDirectory);
252
268
  }
253
269
 
254
270
  function jsonErrorLocation(message, raw) {
@@ -297,7 +313,7 @@ export async function runDoctor(probes, signal) {
297
313
  try {
298
314
  standard = m.AdapterRegistry.load();
299
315
  } catch (error) {
300
- fail(null, `adapter registry failed to load: ${describeLoadError(error, standardConfigFiles())}`);
316
+ fail(null, `adapter registry failed to load: ${describeLoadError(error, standardConfigFiles(m.getClinkxHome))}`);
301
317
  }
302
318
 
303
319
  const childPath = m.getChildConfigPath();