@devflow-tools/sdk 0.18.3 → 0.18.5

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 (49) hide show
  1. package/dist/index.d.ts +3 -1
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +3 -1
  4. package/dist/index.js.map +1 -1
  5. package/dist/paths.d.ts +1 -0
  6. package/dist/paths.d.ts.map +1 -1
  7. package/dist/paths.js +1 -1
  8. package/dist/paths.js.map +1 -1
  9. package/dist/runtime-http-circuit.d.ts +47 -0
  10. package/dist/runtime-http-circuit.d.ts.map +1 -0
  11. package/dist/runtime-http-circuit.js +78 -0
  12. package/dist/runtime-http-circuit.js.map +1 -0
  13. package/dist/runtime-manager.d.ts +121 -0
  14. package/dist/runtime-manager.d.ts.map +1 -0
  15. package/dist/runtime-manager.js +335 -0
  16. package/dist/runtime-manager.js.map +1 -0
  17. package/dist/schemas/dashboard.d.ts +303 -0
  18. package/dist/schemas/dashboard.d.ts.map +1 -0
  19. package/dist/schemas/dashboard.js +110 -0
  20. package/dist/schemas/dashboard.js.map +1 -0
  21. package/dist/types/action.d.ts +10 -0
  22. package/dist/types/action.d.ts.map +1 -0
  23. package/dist/types/action.js +2 -0
  24. package/dist/types/action.js.map +1 -0
  25. package/dist/types/context-pack.d.ts +32 -0
  26. package/dist/types/context-pack.d.ts.map +1 -0
  27. package/dist/types/context-pack.js +2 -0
  28. package/dist/types/context-pack.js.map +1 -0
  29. package/dist/types/dashboard.d.ts +42 -0
  30. package/dist/types/dashboard.d.ts.map +1 -0
  31. package/dist/types/dashboard.js +2 -0
  32. package/dist/types/dashboard.js.map +1 -0
  33. package/dist/types/index.d.ts +5 -0
  34. package/dist/types/index.d.ts.map +1 -1
  35. package/dist/types/index.js +5 -0
  36. package/dist/types/index.js.map +1 -1
  37. package/dist/types/run-dashboard.d.ts +32 -0
  38. package/dist/types/run-dashboard.d.ts.map +1 -0
  39. package/dist/types/run-dashboard.js +2 -0
  40. package/dist/types/run-dashboard.js.map +1 -0
  41. package/dist/types/task-dashboard.d.ts +11 -0
  42. package/dist/types/task-dashboard.d.ts.map +1 -0
  43. package/dist/types/task-dashboard.js +2 -0
  44. package/dist/types/task-dashboard.js.map +1 -0
  45. package/package.json +4 -3
  46. package/dist/runtime-endpoint.d.ts +0 -62
  47. package/dist/runtime-endpoint.d.ts.map +0 -1
  48. package/dist/runtime-endpoint.js +0 -206
  49. package/dist/runtime-endpoint.js.map +0 -1
package/dist/index.d.ts CHANGED
@@ -17,7 +17,8 @@ export * from "./host-adapters/index.js";
17
17
  export { DevFlowApiClient } from "./api-client.js";
18
18
  export * from "./step-templates/index.js";
19
19
  export * from "./paths.js";
20
- export * from "./runtime-endpoint.js";
20
+ export * from "./runtime-manager.js";
21
+ export * from "./runtime-http-circuit.js";
21
22
  export * from "./auth.js";
22
23
  export * from "./plugin-workflow.js";
23
24
  export * from "./claude-hook-runtime.js";
@@ -33,4 +34,5 @@ export * from "./semantic-resolution.js";
33
34
  export * from "./evidence-stable-ref.js";
34
35
  export * from "./retrieval-scope.js";
35
36
  export * from "./project-identity.js";
37
+ export * from "./schemas/dashboard.js";
36
38
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
package/dist/index.js CHANGED
@@ -17,7 +17,8 @@ export * from "./host-adapters/index.js";
17
17
  export { DevFlowApiClient } from "./api-client.js";
18
18
  export * from "./step-templates/index.js";
19
19
  export * from "./paths.js";
20
- export * from "./runtime-endpoint.js";
20
+ export * from "./runtime-manager.js";
21
+ export * from "./runtime-http-circuit.js";
21
22
  export * from "./auth.js";
22
23
  export * from "./plugin-workflow.js";
23
24
  export * from "./claude-hook-runtime.js";
@@ -33,4 +34,5 @@ export * from "./semantic-resolution.js";
33
34
  export * from "./evidence-stable-ref.js";
34
35
  export * from "./retrieval-scope.js";
35
36
  export * from "./project-identity.js";
37
+ export * from "./schemas/dashboard.js";
36
38
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
package/dist/paths.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  export interface DevFlowPathOptions {
2
2
  env?: NodeJS.ProcessEnv;
3
3
  homeDir?: string;
4
+ stateDir?: string;
4
5
  }
5
6
  export declare function getProjectHash(rootPath: string): string;
6
7
  export declare function getDevFlowStateRoot(options?: DevFlowPathOptions): string;
@@ -1 +1 @@
1
- {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAI5E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAS1F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAEvF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE1E;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,MAAmB,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAGR"}
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAI5E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAS1F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAEvF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAE1E;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,MAAmB,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,CAGR"}
package/dist/paths.js CHANGED
@@ -6,7 +6,7 @@ export function getProjectHash(rootPath) {
6
6
  }
7
7
  export function getDevFlowStateRoot(options = {}) {
8
8
  const env = options.env ?? process.env;
9
- const configured = env.DEVFLOW_STATE_DIR?.trim();
9
+ const configured = options.stateDir?.trim() || env.DEVFLOW_STATE_DIR?.trim();
10
10
  return resolve(configured || join(options.homeDir ?? homedir(), ".devflow"));
11
11
  }
12
12
  export function getDaemonSocketPath(rootPath, options) {
package/dist/paths.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO1C,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA8B,EAAE;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAA4B;IAChF,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;SACnC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;SACpC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAChF,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,wBAAwB,MAAM,IAAI,SAAS,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE;QAC3E,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAA4B;IAC7E,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAA4B;IAC/E,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,KAAa,IAAI,CAAC,GAAG,EAAE,EACvB,OAA4B;IAE5B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrF,CAAC"}
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQ1C,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA8B,EAAE;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC7E,OAAO,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAA4B;IAChF,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;SACnC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;SACpC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAChF,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,wBAAwB,MAAM,IAAI,SAAS,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE;QAC3E,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAA4B;IAC7E,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAA4B;IAC/E,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,KAAa,IAAI,CAAC,GAAG,EAAE,EACvB,OAA4B;IAE5B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrF,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { type DevFlowPathOptions } from './paths.js';
2
+ export interface RuntimeHttpCircuitState {
3
+ endpoint: string;
4
+ route: string;
5
+ status: 'closed' | 'open' | 'half_open';
6
+ failures: number;
7
+ lastFailureAt?: number;
8
+ openUntil?: number;
9
+ probeStartedAt?: number;
10
+ fallbackReason?: string;
11
+ updatedAt: number;
12
+ }
13
+ export declare function getRuntimeHttpCircuitPath(options?: DevFlowPathOptions): string;
14
+ export declare function resolveCircuitEndpoint(endpoint: string): string;
15
+ export declare function acquireRuntimeHttpCircuit(endpoint: string, route: string, options?: DevFlowPathOptions & {
16
+ now?: number;
17
+ halfOpenProbeTimeoutMs?: number;
18
+ }): {
19
+ allowed: boolean;
20
+ probe: boolean;
21
+ state: RuntimeHttpCircuitState;
22
+ };
23
+ export declare function registerRuntimeHttpFailure(endpoint: string, route: string, fallbackReason: string, options?: DevFlowPathOptions & {
24
+ now?: number;
25
+ openMs?: number;
26
+ }): {
27
+ transitioned: boolean;
28
+ state: {
29
+ status: "open";
30
+ failures: number;
31
+ lastFailureAt: number;
32
+ openUntil: number;
33
+ probeStartedAt: undefined;
34
+ fallbackReason: string;
35
+ updatedAt: number;
36
+ endpoint: string;
37
+ route: string;
38
+ };
39
+ };
40
+ export declare function registerRuntimeHttpSuccess(endpoint: string, route: string, options?: DevFlowPathOptions & {
41
+ now?: number;
42
+ }): {
43
+ transitioned: boolean;
44
+ state: RuntimeHttpCircuitState;
45
+ };
46
+ export declare function listRuntimeHttpCircuits(options?: DevFlowPathOptions): RuntimeHttpCircuitState[];
47
+ //# sourceMappingURL=runtime-http-circuit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-http-circuit.d.ts","sourceRoot":"","sources":["../src/runtime-http-circuit.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAkB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAO;;;;EAgB9J;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAkB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;kBA3C5J,MAAM;eACT,MAAM;;EAmDd;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAkB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO;;;EAS9H;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,kBAAuB,GAAG,uBAAuB,EAAE,CAEnG"}
@@ -0,0 +1,78 @@
1
+ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { getDevFlowStateRoot } from './paths.js';
5
+ export function getRuntimeHttpCircuitPath(options = {}) {
6
+ return join(getDevFlowStateRoot(options), 'runtime', 'http-circuits.json');
7
+ }
8
+ export function resolveCircuitEndpoint(endpoint) {
9
+ const parsed = new URL(endpoint);
10
+ parsed.pathname = parsed.pathname.replace(/\/+$/u, '') || '/';
11
+ parsed.search = '';
12
+ parsed.hash = '';
13
+ return parsed.toString().replace(/\/$/u, '');
14
+ }
15
+ export function acquireRuntimeHttpCircuit(endpoint, route, options = {}) {
16
+ const now = options.now ?? Date.now();
17
+ const registry = readRegistry(options);
18
+ const key = circuitKey(endpoint, route);
19
+ const current = registry.circuits[key] ?? closed(endpoint, route, now);
20
+ if (current.status === 'open' && (current.openUntil ?? 0) > now)
21
+ return { allowed: false, probe: false, state: current };
22
+ if (current.status === 'half_open' && now - (current.probeStartedAt ?? now) < (options.halfOpenProbeTimeoutMs ?? 5_000)) {
23
+ return { allowed: false, probe: false, state: current };
24
+ }
25
+ if (current.status !== 'closed') {
26
+ const state = { ...current, status: 'half_open', probeStartedAt: now, updatedAt: now };
27
+ registry.circuits[key] = state;
28
+ writeRegistry(registry, options);
29
+ return { allowed: true, probe: true, state };
30
+ }
31
+ return { allowed: true, probe: false, state: current };
32
+ }
33
+ export function registerRuntimeHttpFailure(endpoint, route, fallbackReason, options = {}) {
34
+ const now = options.now ?? Date.now();
35
+ const registry = readRegistry(options);
36
+ const key = circuitKey(endpoint, route);
37
+ const previous = registry.circuits[key] ?? closed(endpoint, route, now);
38
+ const state = { ...previous, status: 'open', failures: previous.failures + 1, lastFailureAt: now, openUntil: now + (options.openMs ?? 60_000), probeStartedAt: undefined, fallbackReason, updatedAt: now };
39
+ registry.circuits[key] = state;
40
+ writeRegistry(registry, options);
41
+ return { transitioned: previous.status !== 'open', state };
42
+ }
43
+ export function registerRuntimeHttpSuccess(endpoint, route, options = {}) {
44
+ const now = options.now ?? Date.now();
45
+ const registry = readRegistry(options);
46
+ const key = circuitKey(endpoint, route);
47
+ const previous = registry.circuits[key] ?? closed(endpoint, route, now);
48
+ const state = closed(endpoint, route, now);
49
+ registry.circuits[key] = state;
50
+ writeRegistry(registry, options);
51
+ return { transitioned: previous.status !== 'closed' || previous.failures > 0, state };
52
+ }
53
+ export function listRuntimeHttpCircuits(options = {}) {
54
+ return Object.values(readRegistry(options).circuits);
55
+ }
56
+ function circuitKey(endpoint, route) { return `${resolveCircuitEndpoint(endpoint)}\0${new URL(route, endpoint).pathname}`; }
57
+ function closed(endpoint, route, now) { return { endpoint: resolveCircuitEndpoint(endpoint), route: new URL(route, endpoint).pathname, status: 'closed', failures: 0, updatedAt: now }; }
58
+ function readRegistry(options) {
59
+ const path = getRuntimeHttpCircuitPath(options);
60
+ if (existsSync(path)) {
61
+ try {
62
+ const value = JSON.parse(readFileSync(path, 'utf8'));
63
+ if (value?.schemaVersion === 'devflow.http-circuits.v2' && value.circuits)
64
+ return value;
65
+ }
66
+ catch { }
67
+ }
68
+ return { schemaVersion: 'devflow.http-circuits.v2', circuits: {}, updatedAt: 0 };
69
+ }
70
+ function writeRegistry(registry, options) {
71
+ const path = getRuntimeHttpCircuitPath(options);
72
+ mkdirSync(join(getDevFlowStateRoot(options), 'runtime'), { recursive: true, mode: 0o700 });
73
+ registry.updatedAt = Date.now();
74
+ const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
75
+ writeFileSync(tmp, `${JSON.stringify(registry)}\n`, { mode: 0o600 });
76
+ renameSync(tmp, path);
77
+ }
78
+ //# sourceMappingURL=runtime-http-circuit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-http-circuit.js","sourceRoot":"","sources":["../src/runtime-http-circuit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,121 @@
1
+ import { type ChildProcess } from 'node:child_process';
2
+ import { type DevFlowPathOptions } from './paths.js';
3
+ export type RuntimeStatus = 'acquiring' | 'launching' | 'ready' | 'degraded' | 'stale' | 'stopping' | 'stopped' | 'failed';
4
+ export type RuntimeFailureCode = 'RUNTIME_ALREADY_READY' | 'RUNTIME_STARTING' | 'RUNTIME_PORT_IN_USE' | 'RUNTIME_START_TIMEOUT' | 'RUNTIME_OWNER_MISMATCH' | 'RUNTIME_STALE_RECOVERED' | 'RUNTIME_PROCESS_EXITED' | 'DASHBOARD_BUNDLE_MISSING' | 'DASHBOARD_NOT_READY' | 'DATABASE_NOT_READY' | 'PROJECT_SCOPE_REQUIRED';
5
+ export interface RuntimeFailure {
6
+ code: RuntimeFailureCode;
7
+ stage: 'lease' | 'port' | 'spawn' | 'health' | 'ready' | 'ownership' | 'stop';
8
+ message: string;
9
+ at: number;
10
+ }
11
+ export interface RuntimeStateV2 {
12
+ schemaVersion: 'devflow.runtime.v2';
13
+ url: string;
14
+ port: number;
15
+ pid: number;
16
+ processGroupId: number;
17
+ ownerToken: string;
18
+ generation: number;
19
+ version: string;
20
+ status: RuntimeStatus;
21
+ dashboardAvailable: boolean;
22
+ dashboardBuildHash?: string;
23
+ startedAt: number;
24
+ lastReadyAt?: number;
25
+ updatedAt: number;
26
+ failure?: RuntimeFailure;
27
+ }
28
+ export interface EnsureRuntimeInput {
29
+ reason: 'cli-start' | 'cli-dashboard' | 'hook' | 'mcp';
30
+ projectRoot?: string;
31
+ port?: number;
32
+ explicitPort?: boolean;
33
+ noStart?: boolean;
34
+ server: {
35
+ command: string;
36
+ args: string[];
37
+ cwd: string;
38
+ env?: NodeJS.ProcessEnv;
39
+ };
40
+ }
41
+ export interface EnsureRuntimeResult {
42
+ state: RuntimeStateV2;
43
+ reused: boolean;
44
+ projectId?: string;
45
+ }
46
+ export interface ReadyProbe {
47
+ health: boolean;
48
+ ready: boolean;
49
+ dashboard: boolean;
50
+ ownerVerified?: boolean;
51
+ version?: string;
52
+ buildHash?: string;
53
+ reason?: RuntimeFailureCode;
54
+ }
55
+ export interface RuntimeManagerOptions extends DevFlowPathOptions {
56
+ startTimeoutMs?: number;
57
+ probe?: (state: RuntimeStateV2) => Promise<ReadyProbe>;
58
+ launcher?: (input: EnsureRuntimeInput['server'] & {
59
+ token: string;
60
+ port: number;
61
+ }) => Promise<{
62
+ pid: number;
63
+ processGroupId?: number;
64
+ child?: ChildProcess;
65
+ }>;
66
+ now?: () => number;
67
+ ports?: {
68
+ isAvailable: (port: number) => Promise<boolean>;
69
+ allocateEphemeral: () => Promise<number>;
70
+ };
71
+ ownership?: {
72
+ inspect: (state: RuntimeStateV2) => {
73
+ alive: boolean;
74
+ commandMatches: boolean;
75
+ tokenMatches: boolean;
76
+ groupMatches: boolean;
77
+ isOwned?: boolean;
78
+ };
79
+ terminateGroup: (state: RuntimeStateV2) => Promise<void>;
80
+ };
81
+ }
82
+ export declare function getRuntimeDir(options?: DevFlowPathOptions): string;
83
+ export declare function getRuntimeStatePath(options?: DevFlowPathOptions): string;
84
+ export declare function getRuntimeDatabasePath(options?: DevFlowPathOptions): string;
85
+ export declare function getRuntimeLogPath(options?: DevFlowPathOptions): string;
86
+ export declare function readRuntimeState(options?: DevFlowPathOptions): RuntimeStateV2 | null;
87
+ export declare function writeRuntimeState(state: RuntimeStateV2, options?: DevFlowPathOptions): void;
88
+ export declare function updateOwnedRuntimeState(generation: number, ownerToken: string, patch: Partial<RuntimeStateV2>, options?: DevFlowPathOptions): boolean;
89
+ export declare function assertRuntimeState(value: RuntimeStateV2): void;
90
+ export declare class RuntimeManager {
91
+ private readonly options;
92
+ constructor(options?: RuntimeManagerOptions);
93
+ readState(): RuntimeStateV2 | null;
94
+ writeState(state: RuntimeStateV2): void;
95
+ updateOwnedState(generation: number, ownerToken: string, patch: Partial<RuntimeStateV2>): boolean;
96
+ ensureRunning(input: EnsureRuntimeInput): Promise<EnsureRuntimeResult>;
97
+ openDashboard(input: EnsureRuntimeInput): Promise<EnsureRuntimeResult>;
98
+ status(): Promise<RuntimeStateV2 | null>;
99
+ stop(): Promise<{
100
+ stopped: boolean;
101
+ state: RuntimeStateV2 | null;
102
+ }>;
103
+ private reserve;
104
+ private newAcquiringState;
105
+ private openLeaseDatabase;
106
+ private upsertLease;
107
+ private writeLeaseAndState;
108
+ private waitForReservation;
109
+ private verifiedReady;
110
+ private waitForReady;
111
+ private selectPort;
112
+ private launch;
113
+ private owns;
114
+ private terminateOwned;
115
+ private processAlive;
116
+ private failAndClean;
117
+ private now;
118
+ private probe;
119
+ }
120
+ export declare function createRuntimeManager(options?: RuntimeManagerOptions): RuntimeManager;
121
+ //# sourceMappingURL=runtime-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-manager.d.ts","sourceRoot":"","sources":["../src/runtime-manager.ts"],"names":[],"mappings":"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"}