@wjarka/cezarion 0.14.9-dev.936 → 0.14.9-dev.941

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.
package/README.md CHANGED
@@ -575,7 +575,7 @@ project), or you point it at one with `--url` / `CEZ_URL`.
575
575
 
576
576
  ```bash
577
577
  id=$(cez task start --task-file - <<'EOF' | jq -r .id
578
- Fix the flaky login test. Quote "anything" you like here.
578
+ Fix the `cez task` docs. Keep $(example) and "quotes" literal.
579
579
  EOF
580
580
  )
581
581
  cez task wait "$id" --until attention --timeout-seconds 900 # 0 done/review · 1 failed · 3 timeout
@@ -584,7 +584,18 @@ cez task send "$id" 'Use the retry helper instead' # queued, delivere
584
584
  cez task log "$id" --follow --timeout-seconds 300 # JSON lines until it ends
585
585
  ```
586
586
 
587
- `cez task start '<task>' --skill <name>` names one skill as the task's agent step;
587
+ Use `--task-file PATH` to read a saved task (for example, `cez task start --task-file task.md`),
588
+ or `--task-file -` to read stdin as above. The quoted heredoc delimiter (`<<'EOF'`) keeps
589
+ backticks and `$()` literal in the task text.
590
+
591
+ POSIX shells, including Bash, expand backticks and `$()` in double-quoted arguments before
592
+ cez receives the text. **Do not put raw backticks in double-quoted task arguments.** This can
593
+ execute parts of your prompt as shell commands and leave holes in the stored task, including
594
+ when starting tasks through SSH and `bash -lc`. Prefer a task file or stdin with a quoted
595
+ heredoc delimiter. A single-quoted positional argument still works for short tasks:
596
+ `cez task start 'Fix the typo'`.
597
+
598
+ `cez task start --task-file task.md --skill <name>` names one skill as the task's agent step;
588
599
  `--skill` and `--workflow` are mutually exclusive. The CLI checks `GET /skills` first and
589
600
  includes a `warning` in its JSON result if the skill is missing or the catalog cannot be
590
601
  checked; it still starts the run. Like a cockpit skill start, if the skill is missing at
@@ -41,11 +41,17 @@ export declare function ciToolRoutes(capabilities: Map<string, Capability>): imp
41
41
  "/api/v1/tools/ci-wait": {
42
42
  $post: {
43
43
  output: {
44
- code: "authentication" | "capacity" | "command_failed" | "gh_missing" | "inaccessible_pr" | "invalid_request" | "malformed_data" | "output_limit" | "persistence" | "query_timeout" | "unauthorized" | "unavailable" | "unsupported_host" | "wait_conflict";
45
- message: string;
44
+ prUrl: string;
45
+ repository: string;
46
+ prNumber: number;
47
+ headSha: string;
48
+ waitId: string;
49
+ registeredAt: string;
50
+ deadline: string;
51
+ phase: "delivered" | "parked" | "registered" | "wake-pending" | "withdrawn";
46
52
  };
47
53
  outputFormat: "json";
48
- status: 503;
54
+ status: import("hono/utils/http-status").ContentfulStatusCode;
49
55
  input: {
50
56
  json: {
51
57
  pr: string;
@@ -54,17 +60,11 @@ export declare function ciToolRoutes(capabilities: Map<string, Capability>): imp
54
60
  };
55
61
  } | {
56
62
  output: {
57
- prUrl: string;
58
- repository: string;
59
- prNumber: number;
60
- headSha: string;
61
- waitId: string;
62
- registeredAt: string;
63
- deadline: string;
64
- phase: "delivered" | "parked" | "registered" | "wake-pending" | "withdrawn";
63
+ code: "authentication" | "capacity" | "command_failed" | "gh_missing" | "inaccessible_pr" | "invalid_request" | "malformed_data" | "output_limit" | "persistence" | "query_timeout" | "unauthorized" | "unavailable" | "unsupported_host" | "wait_conflict";
64
+ message: string;
65
65
  };
66
66
  outputFormat: "json";
67
- status: import("hono/utils/http-status").ContentfulStatusCode;
67
+ status: 503;
68
68
  input: {
69
69
  json: {
70
70
  pr: string;
@@ -439,6 +439,18 @@ export declare function createDelegationRoutes(service: DelegationService, crede
439
439
  } & {
440
440
  "/:workerId": {
441
441
  $get: {
442
+ output: {
443
+ error: string;
444
+ code?: "invalid_input" | undefined;
445
+ };
446
+ outputFormat: "json";
447
+ status: 400;
448
+ input: {
449
+ param: {
450
+ workerId: string;
451
+ };
452
+ };
453
+ } | {
442
454
  output: {
443
455
  workerId: string;
444
456
  parentRunId: string;
@@ -515,7 +527,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
515
527
  workerId: string;
516
528
  };
517
529
  };
518
- } | {
530
+ };
531
+ };
532
+ } & {
533
+ "/:workerId/collect": {
534
+ $post: {
519
535
  output: {
520
536
  error: string;
521
537
  code?: "invalid_input" | undefined;
@@ -526,12 +542,10 @@ export declare function createDelegationRoutes(service: DelegationService, crede
526
542
  param: {
527
543
  workerId: string;
528
544
  };
545
+ } & {
546
+ json: Record<string, never>;
529
547
  };
530
- };
531
- };
532
- } & {
533
- "/:workerId/collect": {
534
- $post: {
548
+ } | {
535
549
  output: {
536
550
  workerId: string;
537
551
  parentRunId: string;
@@ -633,7 +647,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
633
647
  } & {
634
648
  json: Record<string, never>;
635
649
  };
636
- } | {
650
+ };
651
+ };
652
+ } & {
653
+ "/:workerId/steer": {
654
+ $post: {
637
655
  output: {
638
656
  error: string;
639
657
  code?: "invalid_input" | undefined;
@@ -645,13 +663,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
645
663
  workerId: string;
646
664
  };
647
665
  } & {
648
- json: Record<string, never>;
666
+ json: {
667
+ text: string;
668
+ };
649
669
  };
650
- };
651
- };
652
- } & {
653
- "/:workerId/steer": {
654
- $post: {
670
+ } | {
655
671
  output: {
656
672
  workerId: string;
657
673
  state: "delivered" | "queued";
@@ -667,7 +683,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
667
683
  text: string;
668
684
  };
669
685
  };
670
- } | {
686
+ };
687
+ };
688
+ } & {
689
+ "/:workerId/stop": {
690
+ $post: {
671
691
  output: {
672
692
  error: string;
673
693
  code?: "invalid_input" | undefined;
@@ -679,15 +699,9 @@ export declare function createDelegationRoutes(service: DelegationService, crede
679
699
  workerId: string;
680
700
  };
681
701
  } & {
682
- json: {
683
- text: string;
684
- };
702
+ json: Record<string, never>;
685
703
  };
686
- };
687
- };
688
- } & {
689
- "/:workerId/stop": {
690
- $post: {
704
+ } | {
691
705
  output: {
692
706
  workerId: string;
693
707
  state: "stopping" | "terminated";
@@ -701,7 +715,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
701
715
  } & {
702
716
  json: Record<string, never>;
703
717
  };
704
- } | {
718
+ };
719
+ };
720
+ } & {
721
+ "/:workerId/destroy": {
722
+ $post: {
705
723
  output: {
706
724
  error: string;
707
725
  code?: "invalid_input" | undefined;
@@ -715,11 +733,7 @@ export declare function createDelegationRoutes(service: DelegationService, crede
715
733
  } & {
716
734
  json: Record<string, never>;
717
735
  };
718
- };
719
- };
720
- } & {
721
- "/:workerId/destroy": {
722
- $post: {
736
+ } | {
723
737
  output: {
724
738
  workerId: string;
725
739
  state: "complete" | "incomplete";
@@ -742,20 +756,6 @@ export declare function createDelegationRoutes(service: DelegationService, crede
742
756
  } & {
743
757
  json: Record<string, never>;
744
758
  };
745
- } | {
746
- output: {
747
- error: string;
748
- code?: "invalid_input" | undefined;
749
- };
750
- outputFormat: "json";
751
- status: 400;
752
- input: {
753
- param: {
754
- workerId: string;
755
- };
756
- } & {
757
- json: Record<string, never>;
758
- };
759
759
  } | {
760
760
  output: {
761
761
  workerId: string;
@@ -785,13 +785,11 @@ export declare function createDelegationRoutes(service: DelegationService, crede
785
785
  "/:workerId/diff": {
786
786
  $get: {
787
787
  output: {
788
- workerId: string;
789
- baselineSha: string;
790
- diff: string;
791
- truncated: boolean;
788
+ error: string;
789
+ code?: "invalid_input" | undefined;
792
790
  };
793
791
  outputFormat: "json";
794
- status: 200;
792
+ status: 400;
795
793
  input: {
796
794
  param: {
797
795
  workerId: string;
@@ -799,11 +797,13 @@ export declare function createDelegationRoutes(service: DelegationService, crede
799
797
  };
800
798
  } | {
801
799
  output: {
802
- error: string;
803
- code?: "invalid_input" | undefined;
800
+ workerId: string;
801
+ baselineSha: string;
802
+ diff: string;
803
+ truncated: boolean;
804
804
  };
805
805
  outputFormat: "json";
806
- status: 400;
806
+ status: 200;
807
807
  input: {
808
808
  param: {
809
809
  workerId: string;