@geohar/un-bien 0.7.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 (174) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +726 -0
  3. package/dist/actions/handlers.d.ts +77 -0
  4. package/dist/actions/handlers.js +26 -0
  5. package/dist/actions/handlers.js.map +1 -0
  6. package/dist/actions/registry.d.ts +39 -0
  7. package/dist/actions/registry.js +62 -0
  8. package/dist/actions/registry.js.map +1 -0
  9. package/dist/bin/supervisord.d.ts +2 -0
  10. package/dist/bin/supervisord.js +86 -0
  11. package/dist/bin/supervisord.js.map +1 -0
  12. package/dist/config.d.ts +84 -0
  13. package/dist/config.js +115 -0
  14. package/dist/config.js.map +1 -0
  15. package/dist/daemon/client.d.ts +20 -0
  16. package/dist/daemon/client.js +131 -0
  17. package/dist/daemon/client.js.map +1 -0
  18. package/dist/daemon/control_protocol.d.ts +176 -0
  19. package/dist/daemon/control_protocol.js +63 -0
  20. package/dist/daemon/control_protocol.js.map +1 -0
  21. package/dist/daemon/cron_log.d.ts +45 -0
  22. package/dist/daemon/cron_log.js +71 -0
  23. package/dist/daemon/cron_log.js.map +1 -0
  24. package/dist/daemon/cron_registry.d.ts +80 -0
  25. package/dist/daemon/cron_registry.js +198 -0
  26. package/dist/daemon/cron_registry.js.map +1 -0
  27. package/dist/daemon/id.d.ts +24 -0
  28. package/dist/daemon/id.js +36 -0
  29. package/dist/daemon/id.js.map +1 -0
  30. package/dist/daemon/install.d.ts +170 -0
  31. package/dist/daemon/install.js +603 -0
  32. package/dist/daemon/install.js.map +1 -0
  33. package/dist/daemon/registry.d.ts +63 -0
  34. package/dist/daemon/registry.js +153 -0
  35. package/dist/daemon/registry.js.map +1 -0
  36. package/dist/daemon/rpc_child.d.ts +194 -0
  37. package/dist/daemon/rpc_child.js +419 -0
  38. package/dist/daemon/rpc_child.js.map +1 -0
  39. package/dist/daemon/supervisor.d.ts +93 -0
  40. package/dist/daemon/supervisor.js +666 -0
  41. package/dist/daemon/supervisor.js.map +1 -0
  42. package/dist/extension_ui_bridge.d.ts +26 -0
  43. package/dist/extension_ui_bridge.js +341 -0
  44. package/dist/extension_ui_bridge.js.map +1 -0
  45. package/dist/index.d.ts +197 -0
  46. package/dist/index.js +5750 -0
  47. package/dist/index.js.map +1 -0
  48. package/dist/mcp/mesh_result.d.ts +10 -0
  49. package/dist/mcp/mesh_result.js +42 -0
  50. package/dist/mcp/mesh_result.js.map +1 -0
  51. package/dist/mcp/mesh_server.d.ts +16 -0
  52. package/dist/mcp/mesh_server.js +373 -0
  53. package/dist/mcp/mesh_server.js.map +1 -0
  54. package/dist/mesh/canonical.d.ts +30 -0
  55. package/dist/mesh/canonical.js +63 -0
  56. package/dist/mesh/canonical.js.map +1 -0
  57. package/dist/mesh/client.d.ts +18 -0
  58. package/dist/mesh/client.js +127 -0
  59. package/dist/mesh/client.js.map +1 -0
  60. package/dist/mesh/encoding.d.ts +38 -0
  61. package/dist/mesh/encoding.js +217 -0
  62. package/dist/mesh/encoding.js.map +1 -0
  63. package/dist/mesh/self_revoke.d.ts +73 -0
  64. package/dist/mesh/self_revoke.js +407 -0
  65. package/dist/mesh/self_revoke.js.map +1 -0
  66. package/dist/mesh/siblings.d.ts +49 -0
  67. package/dist/mesh/siblings.js +159 -0
  68. package/dist/mesh/siblings.js.map +1 -0
  69. package/dist/mesh/types.d.ts +34 -0
  70. package/dist/mesh/types.js +11 -0
  71. package/dist/mesh/types.js.map +1 -0
  72. package/dist/mesh/verify.d.ts +17 -0
  73. package/dist/mesh/verify.js +86 -0
  74. package/dist/mesh/verify.js.map +1 -0
  75. package/dist/pairing/crypto.d.ts +8 -0
  76. package/dist/pairing/crypto.js +22 -0
  77. package/dist/pairing/crypto.js.map +1 -0
  78. package/dist/pairing/qr.d.ts +59 -0
  79. package/dist/pairing/qr.js +127 -0
  80. package/dist/pairing/qr.js.map +1 -0
  81. package/dist/pairing/storage.d.ts +120 -0
  82. package/dist/pairing/storage.js +614 -0
  83. package/dist/pairing/storage.js.map +1 -0
  84. package/dist/panel_bridge.d.ts +15 -0
  85. package/dist/panel_bridge.js +409 -0
  86. package/dist/panel_bridge.js.map +1 -0
  87. package/dist/paths.d.ts +39 -0
  88. package/dist/paths.js +51 -0
  89. package/dist/paths.js.map +1 -0
  90. package/dist/protocol/codec.d.ts +7 -0
  91. package/dist/protocol/codec.js +48 -0
  92. package/dist/protocol/codec.js.map +1 -0
  93. package/dist/protocol/types.d.ts +404 -0
  94. package/dist/protocol/types.js +2 -0
  95. package/dist/protocol/types.js.map +1 -0
  96. package/dist/rooms.d.ts +42 -0
  97. package/dist/rooms.js +78 -0
  98. package/dist/rooms.js.map +1 -0
  99. package/dist/session/bridge.d.ts +37 -0
  100. package/dist/session/bridge.js +134 -0
  101. package/dist/session/bridge.js.map +1 -0
  102. package/dist/session/broker.d.ts +189 -0
  103. package/dist/session/broker.js +527 -0
  104. package/dist/session/broker.js.map +1 -0
  105. package/dist/session/broker_remote.d.ts +74 -0
  106. package/dist/session/broker_remote.js +581 -0
  107. package/dist/session/broker_remote.js.map +1 -0
  108. package/dist/session/cwd_lock.d.ts +33 -0
  109. package/dist/session/cwd_lock.js +127 -0
  110. package/dist/session/cwd_lock.js.map +1 -0
  111. package/dist/session/debug_log.d.ts +3 -0
  112. package/dist/session/debug_log.js +32 -0
  113. package/dist/session/debug_log.js.map +1 -0
  114. package/dist/session/envelope.d.ts +33 -0
  115. package/dist/session/envelope.js +117 -0
  116. package/dist/session/envelope.js.map +1 -0
  117. package/dist/session/global_config.d.ts +33 -0
  118. package/dist/session/global_config.js +73 -0
  119. package/dist/session/global_config.js.map +1 -0
  120. package/dist/session/ipc.d.ts +27 -0
  121. package/dist/session/ipc.js +22 -0
  122. package/dist/session/ipc.js.map +1 -0
  123. package/dist/session/leader_election.d.ts +32 -0
  124. package/dist/session/leader_election.js +108 -0
  125. package/dist/session/leader_election.js.map +1 -0
  126. package/dist/session/local_config.d.ts +67 -0
  127. package/dist/session/local_config.js +193 -0
  128. package/dist/session/local_config.js.map +1 -0
  129. package/dist/session/mesh_node.d.ts +116 -0
  130. package/dist/session/mesh_node.js +596 -0
  131. package/dist/session/mesh_node.js.map +1 -0
  132. package/dist/session/peer.d.ts +139 -0
  133. package/dist/session/peer.js +474 -0
  134. package/dist/session/peer.js.map +1 -0
  135. package/dist/session/peer_inventory.d.ts +13 -0
  136. package/dist/session/peer_inventory.js +48 -0
  137. package/dist/session/peer_inventory.js.map +1 -0
  138. package/dist/session/peer_limits.d.ts +9 -0
  139. package/dist/session/peer_limits.js +24 -0
  140. package/dist/session/peer_limits.js.map +1 -0
  141. package/dist/session/rpc_envelope.d.ts +108 -0
  142. package/dist/session/rpc_envelope.js +221 -0
  143. package/dist/session/rpc_envelope.js.map +1 -0
  144. package/dist/session/rpc_inbound.d.ts +55 -0
  145. package/dist/session/rpc_inbound.js +136 -0
  146. package/dist/session/rpc_inbound.js.map +1 -0
  147. package/dist/session/setup_wizard.d.ts +39 -0
  148. package/dist/session/setup_wizard.js +63 -0
  149. package/dist/session/setup_wizard.js.map +1 -0
  150. package/dist/session/tools.d.ts +24 -0
  151. package/dist/session/tools.js +272 -0
  152. package/dist/session/tools.js.map +1 -0
  153. package/dist/session/wizard.d.ts +13 -0
  154. package/dist/session/wizard.js +20 -0
  155. package/dist/session/wizard.js.map +1 -0
  156. package/dist/transport/peer_channel.d.ts +52 -0
  157. package/dist/transport/peer_channel.js +145 -0
  158. package/dist/transport/peer_channel.js.map +1 -0
  159. package/dist/transport/pi_forward_client.d.ts +29 -0
  160. package/dist/transport/pi_forward_client.js +68 -0
  161. package/dist/transport/pi_forward_client.js.map +1 -0
  162. package/dist/transport/relay_client.d.ts +96 -0
  163. package/dist/transport/relay_client.js +210 -0
  164. package/dist/transport/relay_client.js.map +1 -0
  165. package/dist/ui/footer.d.ts +32 -0
  166. package/dist/ui/footer.js +34 -0
  167. package/dist/ui/footer.js.map +1 -0
  168. package/docs/daemon.md +289 -0
  169. package/package.json +92 -0
  170. package/service-templates/launchd.plist.template +35 -0
  171. package/service-templates/systemd.service.template +19 -0
  172. package/service-templates/task-launcher.vbs.template +10 -0
  173. package/service-templates/task-scheduler.xml.template +38 -0
  174. package/skills/agent-network/SKILL.md +310 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/daemon/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,176 @@
1
+ /**
2
+ * CLI ↔ supervisor IPC contract for `~/.pi/un-bien/supervisor.sock`.
3
+ *
4
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
5
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
6
+ * both close the connection. No multiplexing, no streaming — each command
7
+ * is a short round-trip.
8
+ *
9
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
10
+ * children themselves is a separate contract — see
11
+ * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
12
+ * This file is strictly the supervisor's own control plane.
13
+ */
14
+ import type { CronJob } from "./cron_registry.js";
15
+ import type { CronLogEntry } from "./cron_log.js";
16
+ /** Per-daemon runtime state observable through the supervisor. */
17
+ export type DaemonState = "running" | "stopped" | "starting" | "crashed";
18
+ export interface DaemonInfo {
19
+ id: string;
20
+ cwd: string;
21
+ name: string;
22
+ state: DaemonState;
23
+ pid?: number;
24
+ uptime_s?: number;
25
+ restart_count?: number;
26
+ }
27
+ /** Requests sent CLI → supervisor. */
28
+ export type ControlRequest = {
29
+ op: "list";
30
+ } | {
31
+ op: "status";
32
+ } | {
33
+ op: "start_all";
34
+ } | {
35
+ op: "start";
36
+ id: string;
37
+ } | {
38
+ op: "stop_all";
39
+ } | {
40
+ op: "stop";
41
+ id: string;
42
+ } | {
43
+ op: "restart_all";
44
+ } | {
45
+ op: "restart";
46
+ id: string;
47
+ } | {
48
+ op: "send";
49
+ id: string;
50
+ text: string;
51
+ } | {
52
+ op: "register";
53
+ cwd: string;
54
+ } | {
55
+ op: "unregister";
56
+ id: string;
57
+ } | {
58
+ op: "cron_add";
59
+ daemon_id: string;
60
+ schedule: string;
61
+ prompt: string;
62
+ tz?: string;
63
+ skip_if_busy?: boolean;
64
+ wake?: boolean;
65
+ catchup?: boolean;
66
+ } | {
67
+ op: "cron_list";
68
+ } | {
69
+ op: "cron_remove";
70
+ job_id: string;
71
+ } | {
72
+ op: "cron_enable";
73
+ job_id: string;
74
+ enabled: boolean;
75
+ } | {
76
+ op: "cron_run";
77
+ job_id: string;
78
+ } | {
79
+ op: "cron_log";
80
+ job_id?: string;
81
+ tail?: number;
82
+ };
83
+ /** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
84
+ export type ControlReply<T = unknown> = {
85
+ ok: true;
86
+ data?: T;
87
+ } | {
88
+ ok: false;
89
+ error: string;
90
+ };
91
+ /**
92
+ * Response shapes per op. Keep in sync with the supervisor handlers in
93
+ * `daemon/supervisor.ts`. Used for typed client calls.
94
+ */
95
+ export interface ControlReplyShapes {
96
+ list: {
97
+ daemons: DaemonInfo[];
98
+ };
99
+ status: {
100
+ daemons: DaemonInfo[];
101
+ };
102
+ start_all: {
103
+ started: string[];
104
+ already_running: string[];
105
+ };
106
+ start: {
107
+ id: string;
108
+ state: DaemonState;
109
+ started: boolean;
110
+ };
111
+ stop_all: {
112
+ stopped: string[];
113
+ already_stopped: string[];
114
+ };
115
+ stop: {
116
+ id: string;
117
+ state: DaemonState;
118
+ stopped: boolean;
119
+ };
120
+ restart_all: {
121
+ restarted: string[];
122
+ };
123
+ restart: {
124
+ id: string;
125
+ state: DaemonState;
126
+ restarted: boolean;
127
+ };
128
+ send: {
129
+ id: string;
130
+ delivered: boolean;
131
+ };
132
+ register: {
133
+ id: string;
134
+ cwd: string;
135
+ };
136
+ unregister: {
137
+ removed: boolean;
138
+ cwd?: string;
139
+ };
140
+ cron_add: {
141
+ job: CronJobView;
142
+ };
143
+ cron_list: {
144
+ jobs: CronJobView[];
145
+ };
146
+ cron_remove: {
147
+ removed: boolean;
148
+ };
149
+ cron_enable: {
150
+ job_id: string;
151
+ enabled: boolean;
152
+ updated: boolean;
153
+ };
154
+ cron_run: {
155
+ job_id: string;
156
+ result: string;
157
+ };
158
+ cron_log: {
159
+ entries: CronLogEntry[];
160
+ };
161
+ }
162
+ /** A cron job plus its computed `next_run` (ISO), for `cron list`. */
163
+ export type CronJobView = CronJob & {
164
+ next_run?: string | null;
165
+ };
166
+ /** Convenience for typed `Client.request<...>("op")` calls. */
167
+ export type ControlReplyFor<Op extends ControlRequest["op"]> = Op extends keyof ControlReplyShapes ? ControlReplyShapes[Op] : never;
168
+ export declare function encodeRequest(req: ControlRequest): string;
169
+ export declare function encodeReply<T>(reply: ControlReply<T>): string;
170
+ /**
171
+ * Parses a single JSON line into a request. Throws on malformed input —
172
+ * the supervisor catches and replies `{ok:false, error}` so the client
173
+ * gets a clean error rather than an unframed disconnect.
174
+ */
175
+ export declare function parseRequest(line: string): ControlRequest;
176
+ export declare function parseReply(line: string): ControlReply<unknown>;
@@ -0,0 +1,63 @@
1
+ /**
2
+ * CLI ↔ supervisor IPC contract for `~/.pi/un-bien/supervisor.sock`.
3
+ *
4
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
5
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
6
+ * both close the connection. No multiplexing, no streaming — each command
7
+ * is a short round-trip.
8
+ *
9
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
10
+ * children themselves is a separate contract — see
11
+ * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
12
+ * This file is strictly the supervisor's own control plane.
13
+ */
14
+ // ── Serialization helpers ────────────────────────────────────────────────────
15
+ const TRAILING_NEWLINE = "\n";
16
+ export function encodeRequest(req) {
17
+ return JSON.stringify(req) + TRAILING_NEWLINE;
18
+ }
19
+ export function encodeReply(reply) {
20
+ return JSON.stringify(reply) + TRAILING_NEWLINE;
21
+ }
22
+ /**
23
+ * Parses a single JSON line into a request. Throws on malformed input —
24
+ * the supervisor catches and replies `{ok:false, error}` so the client
25
+ * gets a clean error rather than an unframed disconnect.
26
+ */
27
+ export function parseRequest(line) {
28
+ let obj;
29
+ try {
30
+ obj = JSON.parse(line);
31
+ }
32
+ catch (e) {
33
+ throw new Error(`malformed control request: ${e.message}`);
34
+ }
35
+ if (!obj || typeof obj !== "object") {
36
+ throw new Error("control request must be a JSON object");
37
+ }
38
+ const op = obj.op;
39
+ if (typeof op !== "string") {
40
+ throw new Error("control request missing string `op` field");
41
+ }
42
+ // We don't validate every field shape here — supervisor handlers do it
43
+ // per-op since the error messages are more specific that way.
44
+ return obj;
45
+ }
46
+ export function parseReply(line) {
47
+ let obj;
48
+ try {
49
+ obj = JSON.parse(line);
50
+ }
51
+ catch (e) {
52
+ throw new Error(`malformed control reply: ${e.message}`);
53
+ }
54
+ if (!obj || typeof obj !== "object") {
55
+ throw new Error("control reply must be a JSON object");
56
+ }
57
+ const ok = obj.ok;
58
+ if (typeof ok !== "boolean") {
59
+ throw new Error("control reply missing boolean `ok` field");
60
+ }
61
+ return obj;
62
+ }
63
+ //# sourceMappingURL=control_protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoFH,gFAAgF;AAEhF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,GAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Append-only audit trail for cron fires at `~/.pi/un-bien/cron.jsonl`.
3
+ *
4
+ * One JSON line per scheduler decision — **every fire AND every skip** — so an
5
+ * operator can see exactly what ran and what didn't (the agent's output goes
6
+ * fire-and-forget to the relay/mesh, so the dispatch itself needs its own
7
+ * trail). Plan/39 decision E.
8
+ */
9
+ /** Outcome of a single `fireJob` decision. */
10
+ export type CronResult = "delivered" | "deliver_failed" | "woke_and_delivered" | "skipped_busy" | "skipped_down" | "skipped_disabled";
11
+ export interface CronLogEntry {
12
+ /** epoch ms */
13
+ ts: number;
14
+ job_id: string;
15
+ daemon_id: string;
16
+ schedule: string;
17
+ /** true when a prompt was actually sent (delivered / woke_and_delivered). */
18
+ fired: boolean;
19
+ result: CronResult;
20
+ /** First chars of the prompt, for at-a-glance log reading. */
21
+ prompt_preview: string;
22
+ }
23
+ /** Test/diag-only: the on-disk path. */
24
+ export declare function cronLogPath(): string;
25
+ /** Maps a result to whether a prompt was actually delivered. */
26
+ export declare function firedFor(result: CronResult): boolean;
27
+ /**
28
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
29
+ * never throws into the scheduler (a logging failure must not abort a fire).
30
+ */
31
+ export declare function appendCronLog(entry: {
32
+ job_id: string;
33
+ daemon_id: string;
34
+ schedule: string;
35
+ result: CronResult;
36
+ prompt: string;
37
+ }): void;
38
+ /**
39
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
40
+ * Missing file → []. Malformed lines are skipped.
41
+ */
42
+ export declare function readCronLog(opts?: {
43
+ jobId?: string;
44
+ tail?: number;
45
+ }): CronLogEntry[];
@@ -0,0 +1,71 @@
1
+ import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { unbienStateHome } from "../paths.js";
4
+ const PREVIEW_LEN = 80;
5
+ function logPath() {
6
+ return join(unbienStateHome(), "cron.jsonl");
7
+ }
8
+ /** Test/diag-only: the on-disk path. */
9
+ export function cronLogPath() {
10
+ return logPath();
11
+ }
12
+ /** Maps a result to whether a prompt was actually delivered. */
13
+ export function firedFor(result) {
14
+ return result === "delivered" || result === "woke_and_delivered";
15
+ }
16
+ /**
17
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
18
+ * never throws into the scheduler (a logging failure must not abort a fire).
19
+ */
20
+ export function appendCronLog(entry) {
21
+ const line = JSON.stringify({
22
+ ts: Date.now(),
23
+ job_id: entry.job_id,
24
+ daemon_id: entry.daemon_id,
25
+ schedule: entry.schedule,
26
+ fired: firedFor(entry.result),
27
+ result: entry.result,
28
+ prompt_preview: entry.prompt.slice(0, PREVIEW_LEN),
29
+ }) + "\n";
30
+ try {
31
+ mkdirSync(dirname(logPath()), { recursive: true });
32
+ appendFileSync(logPath(), line, "utf8");
33
+ }
34
+ catch {
35
+ /* audit is best-effort — don't break the scheduler on a write error */
36
+ }
37
+ }
38
+ /**
39
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
40
+ * Missing file → []. Malformed lines are skipped.
41
+ */
42
+ export function readCronLog(opts = {}) {
43
+ if (!existsSync(logPath()))
44
+ return [];
45
+ let raw;
46
+ try {
47
+ raw = readFileSync(logPath(), "utf8");
48
+ }
49
+ catch {
50
+ return [];
51
+ }
52
+ const entries = [];
53
+ for (const line of raw.split("\n")) {
54
+ if (!line.trim())
55
+ continue;
56
+ try {
57
+ const e = JSON.parse(line);
58
+ if (opts.jobId && e.job_id !== opts.jobId)
59
+ continue;
60
+ entries.push(e);
61
+ }
62
+ catch {
63
+ /* skip malformed */
64
+ }
65
+ }
66
+ if (opts.tail !== undefined && opts.tail >= 0 && entries.length > opts.tail) {
67
+ return entries.slice(entries.length - opts.tail);
68
+ }
69
+ return entries;
70
+ }
71
+ //# sourceMappingURL=cron_log.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron_log.js","sourceRoot":"","sources":["../../src/daemon/cron_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiC9C,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,OAAO;IACd,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,MAAkB;IACzC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,oBAAoB,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAM7B;IACC,MAAM,IAAI,GACR,IAAI,CAAC,SAAS,CAAC;QACb,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;KAC5B,CAAC,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAA0C,EAAE;IAE5C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK;gBAAE,SAAS;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,80 @@
1
+ /**
2
+ * Cron registry: scheduled prompts for daemons, persisted at
3
+ * `~/.pi/un-bien/cron.json`. Mirrors `registry.ts` (`daemons.json`) — tolerant
4
+ * load (missing/corrupt → empty), atomic-ish full-file save.
5
+ *
6
+ * Each job targets a daemon by its `daemon_id` (the 8-hex id from
7
+ * `daemonIdForCwd`) and fires `prompt` on `schedule` (a cron expression, run
8
+ * by croner in the supervisor). The scheduler engine + `fireJob` live in
9
+ * `supervisor.ts`; this module only owns persistence + schedule validation.
10
+ *
11
+ * Plan/39. Decisions B (croner), C (min-interval 60s), E (audit via cron_log).
12
+ */
13
+ /** Minimum allowed interval between two consecutive runs of a schedule. */
14
+ export declare const MIN_INTERVAL_MS = 60000;
15
+ /** A scheduled prompt. */
16
+ export interface CronJob {
17
+ /** `j_<hex>` — random, stable across restarts. */
18
+ id: string;
19
+ /** Target daemon id (`daemonIdForCwd`). */
20
+ daemon_id: string;
21
+ /** Cron expression (croner syntax; optional 6th seconds field supported). */
22
+ schedule: string;
23
+ /** IANA timezone for the schedule (e.g. "America/Sao_Paulo"). */
24
+ tz?: string;
25
+ /** Prompt text injected into the daemon when the job fires. */
26
+ prompt: string;
27
+ enabled: boolean;
28
+ /** Skip the fire when the daemon is mid-turn (default true). */
29
+ skip_if_busy: boolean;
30
+ /** Start the daemon if it's down, then fire (default false). */
31
+ wake: boolean;
32
+ /** On supervisor start, run once if the previous scheduled run was missed
33
+ * while it was down (default false; at most 1×). */
34
+ catchup: boolean;
35
+ created_at: string;
36
+ last_run?: string;
37
+ /** Last fire result — see cron_log `result` values. Shortcut for `cron list`. */
38
+ last_status?: string;
39
+ }
40
+ export interface CronRegistry {
41
+ jobs: CronJob[];
42
+ }
43
+ /** Test/diag-only: the on-disk path. */
44
+ export declare function cronRegistryPath(): string;
45
+ /** Reads the registry; returns empty on missing/corrupt file. */
46
+ export declare function loadCronRegistry(): CronRegistry;
47
+ export declare function saveCronRegistry(reg: CronRegistry): void;
48
+ export declare function listJobs(): CronJob[];
49
+ export declare function getJob(id: string): CronJob | undefined;
50
+ /** Fields a caller supplies when creating a job. Flags default sensibly. */
51
+ export interface NewJobInput {
52
+ daemon_id: string;
53
+ schedule: string;
54
+ prompt: string;
55
+ tz?: string;
56
+ skip_if_busy?: boolean;
57
+ wake?: boolean;
58
+ catchup?: boolean;
59
+ }
60
+ /** Adds a job with a fresh `j_<hex>` id. Pure persistence — call
61
+ * `validateSchedule` first at the op/CLI boundary. */
62
+ export declare function addJob(input: NewJobInput): CronJob;
63
+ export declare function removeJob(id: string): boolean;
64
+ export declare function setJobEnabled(id: string, enabled: boolean): boolean;
65
+ /** Records the outcome of a fire on the job (the `cron list` shortcut). */
66
+ export declare function recordRun(id: string, at: string, status: string): void;
67
+ export interface ScheduleValidation {
68
+ ok: boolean;
69
+ error?: string;
70
+ /** Interval (ms) between the next two runs, when computable. */
71
+ intervalMs?: number;
72
+ }
73
+ /**
74
+ * Validates a cron expression via croner and enforces the ≥60s min-interval
75
+ * (decision C — guards against pileup + token burn). Returns `ok:false` with a
76
+ * user-facing message on a bad expression or a too-frequent schedule.
77
+ */
78
+ export declare function validateSchedule(schedule: string, tz?: string): ScheduleValidation;
79
+ /** Returns the next scheduled run for a job, or null. Used by `cron list`. */
80
+ export declare function nextRunFor(job: CronJob): Date | null;
@@ -0,0 +1,198 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { randomBytes } from "node:crypto";
3
+ import { dirname, join } from "node:path";
4
+ import { Cron } from "croner";
5
+ import { unbienStateHome } from "../paths.js";
6
+ /**
7
+ * Cron registry: scheduled prompts for daemons, persisted at
8
+ * `~/.pi/un-bien/cron.json`. Mirrors `registry.ts` (`daemons.json`) — tolerant
9
+ * load (missing/corrupt → empty), atomic-ish full-file save.
10
+ *
11
+ * Each job targets a daemon by its `daemon_id` (the 8-hex id from
12
+ * `daemonIdForCwd`) and fires `prompt` on `schedule` (a cron expression, run
13
+ * by croner in the supervisor). The scheduler engine + `fireJob` live in
14
+ * `supervisor.ts`; this module only owns persistence + schedule validation.
15
+ *
16
+ * Plan/39. Decisions B (croner), C (min-interval 60s), E (audit via cron_log).
17
+ */
18
+ /** Minimum allowed interval between two consecutive runs of a schedule. */
19
+ export const MIN_INTERVAL_MS = 60_000;
20
+ function cronPath() {
21
+ return join(unbienStateHome(), "cron.json");
22
+ }
23
+ /** Test/diag-only: the on-disk path. */
24
+ export function cronRegistryPath() {
25
+ return cronPath();
26
+ }
27
+ /** Reads the registry; returns empty on missing/corrupt file. */
28
+ export function loadCronRegistry() {
29
+ if (!existsSync(cronPath()))
30
+ return { jobs: [] };
31
+ try {
32
+ const parsed = JSON.parse(readFileSync(cronPath(), "utf8"));
33
+ if (!parsed || typeof parsed !== "object")
34
+ return { jobs: [] };
35
+ const arr = parsed.jobs;
36
+ if (!Array.isArray(arr))
37
+ return { jobs: [] };
38
+ const jobs = [];
39
+ for (const item of arr) {
40
+ const job = _coerceJob(item);
41
+ if (job)
42
+ jobs.push(job);
43
+ }
44
+ return { jobs };
45
+ }
46
+ catch {
47
+ return { jobs: [] };
48
+ }
49
+ }
50
+ export function saveCronRegistry(reg) {
51
+ mkdirSync(dirname(cronPath()), { recursive: true });
52
+ writeFileSync(cronPath(), JSON.stringify(reg, null, 2) + "\n");
53
+ }
54
+ export function listJobs() {
55
+ return loadCronRegistry().jobs;
56
+ }
57
+ export function getJob(id) {
58
+ return loadCronRegistry().jobs.find((j) => j.id === id);
59
+ }
60
+ /** Adds a job with a fresh `j_<hex>` id. Pure persistence — call
61
+ * `validateSchedule` first at the op/CLI boundary. */
62
+ export function addJob(input) {
63
+ const reg = loadCronRegistry();
64
+ const job = {
65
+ id: _freshId(reg.jobs),
66
+ daemon_id: input.daemon_id,
67
+ schedule: input.schedule,
68
+ prompt: input.prompt,
69
+ enabled: true,
70
+ skip_if_busy: input.skip_if_busy ?? true,
71
+ wake: input.wake ?? false,
72
+ catchup: input.catchup ?? false,
73
+ created_at: new Date().toISOString(),
74
+ };
75
+ if (input.tz)
76
+ job.tz = input.tz;
77
+ reg.jobs.push(job);
78
+ saveCronRegistry(reg);
79
+ return job;
80
+ }
81
+ export function removeJob(id) {
82
+ const reg = loadCronRegistry();
83
+ const idx = reg.jobs.findIndex((j) => j.id === id);
84
+ if (idx === -1)
85
+ return false;
86
+ reg.jobs.splice(idx, 1);
87
+ saveCronRegistry(reg);
88
+ return true;
89
+ }
90
+ export function setJobEnabled(id, enabled) {
91
+ const reg = loadCronRegistry();
92
+ const job = reg.jobs.find((j) => j.id === id);
93
+ if (!job)
94
+ return false;
95
+ job.enabled = enabled;
96
+ saveCronRegistry(reg);
97
+ return true;
98
+ }
99
+ /** Records the outcome of a fire on the job (the `cron list` shortcut). */
100
+ export function recordRun(id, at, status) {
101
+ const reg = loadCronRegistry();
102
+ const job = reg.jobs.find((j) => j.id === id);
103
+ if (!job)
104
+ return;
105
+ job.last_run = at;
106
+ job.last_status = status;
107
+ saveCronRegistry(reg);
108
+ }
109
+ /**
110
+ * Validates a cron expression via croner and enforces the ≥60s min-interval
111
+ * (decision C — guards against pileup + token burn). Returns `ok:false` with a
112
+ * user-facing message on a bad expression or a too-frequent schedule.
113
+ */
114
+ export function validateSchedule(schedule, tz) {
115
+ let cron;
116
+ try {
117
+ cron = new Cron(schedule, tz ? { timezone: tz } : {});
118
+ }
119
+ catch (e) {
120
+ return {
121
+ ok: false,
122
+ error: `invalid cron expression: ${e.message}`,
123
+ };
124
+ }
125
+ try {
126
+ const n1 = cron.nextRun();
127
+ const n2 = n1 ? cron.nextRun(n1) : null;
128
+ if (!n1 || !n2)
129
+ return { ok: false, error: "schedule has no upcoming runs" };
130
+ const intervalMs = n2.getTime() - n1.getTime();
131
+ if (intervalMs < MIN_INTERVAL_MS) {
132
+ return {
133
+ ok: false,
134
+ intervalMs,
135
+ error: `schedule too frequent: ~${Math.round(intervalMs / 1000)}s between runs (minimum is 60s)`,
136
+ };
137
+ }
138
+ return { ok: true, intervalMs };
139
+ }
140
+ finally {
141
+ cron.stop();
142
+ }
143
+ }
144
+ /** Returns the next scheduled run for a job, or null. Used by `cron list`. */
145
+ export function nextRunFor(job) {
146
+ try {
147
+ const cron = new Cron(job.schedule, job.tz ? { timezone: job.tz } : {});
148
+ const n = cron.nextRun();
149
+ cron.stop();
150
+ return n;
151
+ }
152
+ catch {
153
+ return null;
154
+ }
155
+ }
156
+ // ── internals ───────────────────────────────────────────────────────────────
157
+ function _freshId(existing) {
158
+ for (let i = 0; i < 1000; i++) {
159
+ const id = `j_${randomBytes(4).toString("hex")}`;
160
+ if (!existing.some((j) => j.id === id))
161
+ return id;
162
+ }
163
+ throw new Error("cron id space exhausted");
164
+ }
165
+ function _coerceJob(item) {
166
+ if (!item || typeof item !== "object")
167
+ return null;
168
+ const o = item;
169
+ if (typeof o["id"] !== "string")
170
+ return null;
171
+ if (typeof o["daemon_id"] !== "string")
172
+ return null;
173
+ if (typeof o["schedule"] !== "string")
174
+ return null;
175
+ if (typeof o["prompt"] !== "string")
176
+ return null;
177
+ const job = {
178
+ id: o["id"],
179
+ daemon_id: o["daemon_id"],
180
+ schedule: o["schedule"],
181
+ prompt: o["prompt"],
182
+ enabled: o["enabled"] !== false,
183
+ skip_if_busy: o["skip_if_busy"] !== false,
184
+ wake: o["wake"] === true,
185
+ catchup: o["catchup"] === true,
186
+ created_at: typeof o["created_at"] === "string"
187
+ ? o["created_at"]
188
+ : new Date(0).toISOString(),
189
+ };
190
+ if (typeof o["tz"] === "string")
191
+ job.tz = o["tz"];
192
+ if (typeof o["last_run"] === "string")
193
+ job.last_run = o["last_run"];
194
+ if (typeof o["last_status"] === "string")
195
+ job.last_status = o["last_status"];
196
+ return job;
197
+ }
198
+ //# sourceMappingURL=cron_registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cron_registry.js","sourceRoot":"","sources":["../../src/daemon/cron_registry.ts"],"names":[],"mappings":"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"}