owenloop 0.4.1 → 0.5.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 (154) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +58 -31
  3. package/bin/owenloop.mjs +2 -2
  4. package/dist/packages/work/src/agent/brief.d.ts +172 -0
  5. package/dist/packages/work/src/agent/brief.js +193 -0
  6. package/dist/packages/work/src/agent/loop.d.ts +135 -0
  7. package/dist/packages/work/src/agent/loop.js +542 -0
  8. package/dist/packages/work/src/agent/workdir.d.ts +210 -0
  9. package/dist/packages/work/src/agent/workdir.js +319 -0
  10. package/dist/packages/work/src/bundle/cache.d.ts +90 -0
  11. package/dist/packages/work/src/bundle/cache.js +324 -0
  12. package/dist/packages/work/src/bundle/fetch.d.ts +85 -0
  13. package/dist/packages/work/src/bundle/fetch.js +325 -0
  14. package/dist/packages/work/src/bundle/types.d.ts +160 -0
  15. package/dist/packages/work/src/bundle/types.js +1 -0
  16. package/dist/packages/work/src/credentials/owenloop.d.ts +11 -0
  17. package/dist/packages/work/src/credentials/owenloop.js +28 -0
  18. package/dist/packages/work/src/credentials/reader.d.ts +36 -0
  19. package/dist/packages/work/src/credentials/reader.js +32 -0
  20. package/dist/packages/work/src/credentials/resolve.d.ts +19 -0
  21. package/dist/packages/work/src/credentials/resolve.js +56 -0
  22. package/dist/packages/work/src/exec/loop.d.ts +29 -0
  23. package/dist/packages/work/src/exec/loop.js +215 -0
  24. package/dist/packages/work/src/exec/receipt.d.ts +38 -0
  25. package/dist/packages/work/src/exec/receipt.js +21 -0
  26. package/dist/packages/work/src/exec/runner.d.ts +65 -0
  27. package/dist/packages/work/src/exec/runner.js +185 -0
  28. package/dist/packages/work/src/harness/child-env.d.ts +100 -0
  29. package/dist/packages/work/src/harness/child-env.js +127 -0
  30. package/dist/packages/work/src/harness/claude.d.ts +128 -0
  31. package/dist/packages/work/src/harness/claude.js +635 -0
  32. package/dist/packages/work/src/harness/codex.d.ts +110 -0
  33. package/dist/packages/work/src/harness/codex.js +896 -0
  34. package/dist/packages/work/src/harness/contract.d.ts +283 -0
  35. package/dist/packages/work/src/harness/contract.js +32 -0
  36. package/dist/packages/work/src/harness/fake.d.ts +59 -0
  37. package/dist/packages/work/src/harness/fake.js +90 -0
  38. package/dist/packages/work/src/harness/jsonrpc-stdio.d.ts +108 -0
  39. package/dist/packages/work/src/harness/jsonrpc-stdio.js +344 -0
  40. package/dist/packages/work/src/harness/permissions.d.ts +62 -0
  41. package/dist/packages/work/src/harness/permissions.js +93 -0
  42. package/dist/packages/work/src/harness/registry.d.ts +47 -0
  43. package/dist/packages/work/src/harness/registry.js +45 -0
  44. package/dist/packages/work/src/harness/session-store.d.ts +163 -0
  45. package/dist/packages/work/src/harness/session-store.js +319 -0
  46. package/dist/packages/work/src/harness/types.d.ts +29 -0
  47. package/dist/packages/work/src/harness/types.js +14 -0
  48. package/dist/packages/work/src/harnesses.d.ts +38 -0
  49. package/dist/packages/work/src/harnesses.js +38 -0
  50. package/dist/packages/work/src/hold/loop.d.ts +36 -0
  51. package/dist/packages/work/src/hold/loop.js +23 -0
  52. package/dist/packages/work/src/hold/mcp.d.ts +55 -0
  53. package/dist/packages/work/src/hold/mcp.js +149 -0
  54. package/dist/packages/work/src/hub/client.d.ts +22 -0
  55. package/dist/packages/work/src/hub/client.js +78 -0
  56. package/dist/packages/work/src/hub/types.d.ts +290 -0
  57. package/dist/packages/work/src/hub/types.js +28 -0
  58. package/dist/packages/work/src/lease/loop.d.ts +94 -0
  59. package/dist/packages/work/src/lease/loop.js +277 -0
  60. package/dist/packages/work/src/main.d.ts +1 -0
  61. package/dist/packages/work/src/main.js +48 -0
  62. package/dist/packages/work/src/mcp/server.d.ts +125 -0
  63. package/dist/packages/work/src/mcp/server.js +320 -0
  64. package/dist/packages/work/src/roles/agent-run.d.ts +118 -0
  65. package/dist/packages/work/src/roles/agent-run.js +447 -0
  66. package/dist/packages/work/src/roles/exec.d.ts +40 -0
  67. package/dist/packages/work/src/roles/exec.js +203 -0
  68. package/dist/packages/work/src/roles/hold.d.ts +68 -0
  69. package/dist/packages/work/src/roles/hold.js +324 -0
  70. package/dist/packages/work/src/roles/join.d.ts +18 -0
  71. package/dist/packages/work/src/roles/join.js +204 -0
  72. package/dist/packages/work/src/roles/lint.d.ts +59 -0
  73. package/dist/packages/work/src/roles/lint.js +200 -0
  74. package/dist/packages/work/src/roles/prepare.d.ts +1 -0
  75. package/dist/packages/work/src/roles/prepare.js +249 -0
  76. package/dist/packages/work/src/roles/release.d.ts +48 -0
  77. package/dist/packages/work/src/roles/release.js +137 -0
  78. package/dist/packages/work/src/roles/sessions.d.ts +61 -0
  79. package/dist/packages/work/src/roles/sessions.js +180 -0
  80. package/dist/packages/work/src/roles/settings.d.ts +6 -0
  81. package/dist/packages/work/src/roles/settings.js +66 -0
  82. package/dist/packages/work/src/roles/shift.d.ts +12 -0
  83. package/dist/packages/work/src/roles/shift.js +228 -0
  84. package/dist/packages/work/src/roles/signals.d.ts +55 -0
  85. package/dist/packages/work/src/roles/signals.js +62 -0
  86. package/dist/packages/work/src/settings/provision.d.ts +21 -0
  87. package/dist/packages/work/src/settings/provision.js +47 -0
  88. package/dist/packages/work/src/settings/settings.d.ts +120 -0
  89. package/dist/packages/work/src/settings/settings.js +116 -0
  90. package/dist/packages/work/src/shift/client.d.ts +24 -0
  91. package/dist/packages/work/src/shift/client.js +124 -0
  92. package/dist/packages/work/src/shift/loop.d.ts +120 -0
  93. package/dist/packages/work/src/shift/loop.js +468 -0
  94. package/dist/packages/work/src/shift/protocol.d.ts +91 -0
  95. package/dist/packages/work/src/shift/protocol.js +24 -0
  96. package/dist/packages/work/src/shift/routing.d.ts +35 -0
  97. package/dist/packages/work/src/shift/routing.js +50 -0
  98. package/dist/packages/work/src/shift/runtime.d.ts +43 -0
  99. package/dist/packages/work/src/shift/runtime.js +274 -0
  100. package/dist/packages/work/src/shift/server.d.ts +23 -0
  101. package/dist/packages/work/src/shift/server.js +716 -0
  102. package/dist/packages/work/src/shift/spawn.d.ts +86 -0
  103. package/dist/packages/work/src/shift/spawn.js +100 -0
  104. package/dist/packages/work/src/shift/state.d.ts +77 -0
  105. package/dist/packages/work/src/shift/state.js +162 -0
  106. package/dist/packages/work/src/usage.d.ts +6 -0
  107. package/dist/packages/work/src/usage.js +175 -0
  108. package/dist/{cli.d.ts → src/cli.d.ts} +18 -3
  109. package/dist/{cli.js → src/cli.js} +770 -114
  110. package/dist/{credentials.d.ts → src/credentials.d.ts} +18 -12
  111. package/dist/{credentials.js → src/credentials.js} +14 -12
  112. package/dist/{defs.js → src/defs.js} +36 -36
  113. package/dist/{engine.d.ts → src/engine.d.ts} +8 -8
  114. package/dist/{engine.js → src/engine.js} +14 -14
  115. package/dist/{hub.d.ts → src/hub.d.ts} +205 -10
  116. package/dist/{hub.js → src/hub.js} +370 -12
  117. package/dist/{index.d.ts → src/index.d.ts} +1 -1
  118. package/dist/{index.js → src/index.js} +1 -1
  119. package/dist/{mcp → src/mcp}/serve.d.ts +5 -4
  120. package/dist/{mcp → src/mcp}/serve.js +168 -31
  121. package/dist/{mcp → src/mcp}/server.d.ts +6 -9
  122. package/dist/{mcp → src/mcp}/server.js +6 -9
  123. package/dist/{model.js → src/model.js} +1 -1
  124. package/dist/{types.d.ts → src/types.d.ts} +18 -18
  125. package/dist/{util.d.ts → src/util.d.ts} +3 -2
  126. package/dist/{util.js → src/util.js} +3 -2
  127. package/dist/{owenwork.d.ts → src/work-settings.d.ts} +22 -22
  128. package/dist/{owenwork.js → src/work-settings.js} +27 -27
  129. package/docs/authoring.md +93 -53
  130. package/docs/cli.md +597 -76
  131. package/docs/design.md +33 -33
  132. package/docs/embedding.md +10 -9
  133. package/examples/workflows/{command-worker.yaml → command-executor.yaml} +15 -15
  134. package/examples/workflows/compile-dev-playbook.yaml +338 -0
  135. package/examples/workflows/judges/gate-sharpness.md +39 -0
  136. package/examples/workflows/judges/security.md +34 -0
  137. package/package.json +17 -8
  138. /package/dist/{add.d.ts → src/add.d.ts} +0 -0
  139. /package/dist/{add.js → src/add.js} +0 -0
  140. /package/dist/{defs.d.ts → src/defs.d.ts} +0 -0
  141. /package/dist/{factory.d.ts → src/factory.d.ts} +0 -0
  142. /package/dist/{factory.js → src/factory.js} +0 -0
  143. /package/dist/{lock.d.ts → src/lock.d.ts} +0 -0
  144. /package/dist/{lock.js → src/lock.js} +0 -0
  145. /package/dist/{model.d.ts → src/model.d.ts} +0 -0
  146. /package/dist/{paths.d.ts → src/paths.d.ts} +0 -0
  147. /package/dist/{paths.js → src/paths.js} +0 -0
  148. /package/dist/{schema.d.ts → src/schema.d.ts} +0 -0
  149. /package/dist/{schema.js → src/schema.js} +0 -0
  150. /package/dist/{store.d.ts → src/store.d.ts} +0 -0
  151. /package/dist/{store.js → src/store.js} +0 -0
  152. /package/dist/{types.js → src/types.js} +0 -0
  153. /package/dist/{untar.d.ts → src/untar.d.ts} +0 -0
  154. /package/dist/{untar.js → src/untar.js} +0 -0
@@ -0,0 +1,43 @@
1
+ import { installSignalHandlers, type SignalHost } from '../roles/signals.ts';
2
+ export { installSignalHandlers, type SignalHost };
3
+ export declare function resolveCap(flagCap: number | undefined, settingsCap: number | undefined): number;
4
+ export declare function resolveStateDirOverride(flag: string | undefined, env: Record<string, string | undefined>, settingsStateDir: string | undefined): string | undefined;
5
+ export declare function resolveMaxConcurrentAgents(flagMax: number | undefined, settingsMax: number | undefined): number;
6
+ export declare function resolveShiftName(flagName: string | undefined, opts?: {
7
+ shiftId?: string;
8
+ hostname?: string;
9
+ cwd?: string;
10
+ pid?: number;
11
+ }): string;
12
+ export interface ParsedArgs {
13
+ origin?: string;
14
+ as?: string;
15
+ name?: string;
16
+ serveCrews?: string[];
17
+ cap?: number;
18
+ workflow?: string;
19
+ pollIntervalMs?: number;
20
+ once?: boolean;
21
+ maxAgents?: number;
22
+ cacheDir?: string;
23
+ stateDir?: string;
24
+ error?: string;
25
+ }
26
+ /** Parse shift's internal `--flag value` and `--flag=value` forms. */
27
+ export declare function parseArgs(args: string[]): ParsedArgs;
28
+ export interface ShiftRuntimeOptions {
29
+ /** Build the Unix-socket shift daemon around the same loop instead of self-driving directly. */
30
+ daemon?: boolean;
31
+ /** Output prefix for errors and lifecycle messages. */
32
+ role?: 'shift';
33
+ /** Socket path selected by the shift command. */
34
+ socketPath?: string;
35
+ }
36
+ /**
37
+ * Shared runtime setup for the internal shift and public shift daemon.
38
+ * `parsed` is already grammar-validated by the caller; this function owns all
39
+ * credential/settings/cache/spawner resolution so the two entry points cannot
40
+ * drift.
41
+ */
42
+ export declare function runShiftRuntime(parsed: ParsedArgs, options?: ShiftRuntimeOptions): Promise<number>;
43
+ export declare function run(args: string[]): Promise<number>;
@@ -0,0 +1,274 @@
1
+ /**
2
+ * `owenloop work shift` — the internal standing Shift loop.
3
+ *
4
+ * The human-facing shift daemon uses the same setup and ShiftLoop through
5
+ * `runShiftRuntime(..., { daemon: true })`; this module remains the single place
6
+ * that resolves settings, credentials, caches, child spawners, and signal
7
+ * behavior. The retired shift stdio-MCP mount is intentionally absent.
8
+ */
9
+ import { randomUUID } from 'node:crypto';
10
+ import { hostname } from 'node:os';
11
+ import { basename, join } from 'node:path';
12
+ import { createHubClient } from "../hub/client.js";
13
+ import { resolveBearer } from "../credentials/resolve.js";
14
+ import { loadSettings } from "../settings/settings.js";
15
+ import { resolveCacheDir } from "../bundle/cache.js";
16
+ import { createShiftLoop } from "./loop.js";
17
+ import { createDefaultSpawner } from "./spawn.js";
18
+ import { resolveStateDir, ensureStateDir, reconcileInFlight } from "./state.js";
19
+ import { reconcileActiveSessions, sessionsPath } from "../harness/session-store.js";
20
+ import { resolveWorkRepo, resolveWorkRoot } from "../agent/workdir.js";
21
+ import { installSignalHandlers } from "../roles/signals.js";
22
+ import { createShiftDaemon } from "./server.js";
23
+ // Re-exported so existing importers keep their import site while the
24
+ // implementation lives in the shared signals seam.
25
+ export { installSignalHandlers };
26
+ const DEFAULT_CAP = 3;
27
+ const DEFAULT_POLL_MS = 5_000;
28
+ const DEFAULT_MAX_AGENTS = 4;
29
+ const DEFAULT_PRESENCE_MS = 60_000;
30
+ export function resolveCap(flagCap, settingsCap) {
31
+ return flagCap ?? settingsCap ?? DEFAULT_CAP;
32
+ }
33
+ export function resolveStateDirOverride(flag, env, settingsStateDir) {
34
+ return flag ?? env['OWENLOOP_STATE_DIR'] ?? settingsStateDir;
35
+ }
36
+ export function resolveMaxConcurrentAgents(flagMax, settingsMax) {
37
+ return flagMax ?? settingsMax ?? DEFAULT_MAX_AGENTS;
38
+ }
39
+ export function resolveShiftName(flagName, opts = {}) {
40
+ if (flagName !== undefined && flagName !== '')
41
+ return flagName;
42
+ const suffix = opts.shiftId !== undefined && opts.shiftId !== ''
43
+ ? opts.shiftId.replace(/^shf_/, '').replace(/-/g, '').slice(0, 6)
44
+ : `p${opts.pid ?? process.pid}`;
45
+ return `${opts.hostname ?? hostname()}/${basename(opts.cwd ?? process.cwd())}#${suffix}`;
46
+ }
47
+ /** Parse shift's internal `--flag value` and `--flag=value` forms. */
48
+ export function parseArgs(args) {
49
+ const parsed = {};
50
+ const takeValue = (a, i) => {
51
+ const eq = a.indexOf('=');
52
+ if (eq !== -1)
53
+ return { value: a.slice(eq + 1), next: i };
54
+ const v = args[i + 1];
55
+ if (v === undefined)
56
+ return { error: `missing value for ${a}` };
57
+ return { value: v, next: i + 1 };
58
+ };
59
+ const intFlag = (raw, flag) => {
60
+ const n = Number(raw);
61
+ if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) {
62
+ return { error: `${flag} must be a non-negative integer, got '${raw}'` };
63
+ }
64
+ return n;
65
+ };
66
+ for (let i = 0; i < args.length; i++) {
67
+ const a = args[i];
68
+ const name = a.startsWith('--') && a.includes('=') ? a.slice(0, a.indexOf('=')) : a;
69
+ switch (name) {
70
+ case '--once':
71
+ parsed.once = true;
72
+ break;
73
+ case '--origin':
74
+ case '--as':
75
+ case '--name':
76
+ case '--serve-crews':
77
+ case '--cap':
78
+ case '--max-agents':
79
+ case '--workflow':
80
+ case '--poll-interval':
81
+ case '--cache-dir':
82
+ case '--state-dir': {
83
+ const r = takeValue(a, i);
84
+ if ('error' in r)
85
+ return { error: r.error };
86
+ i = r.next;
87
+ if (name === '--origin')
88
+ parsed.origin = r.value;
89
+ else if (name === '--as')
90
+ parsed.as = r.value;
91
+ else if (name === '--name') {
92
+ if (r.value.trim() === '')
93
+ return { error: '--name requires a non-empty value' };
94
+ parsed.name = r.value;
95
+ }
96
+ else if (name === '--serve-crews') {
97
+ parsed.serveCrews = r.value.split(',').map((s) => s.trim()).filter((s) => s !== '');
98
+ }
99
+ else if (name === '--workflow')
100
+ parsed.workflow = r.value;
101
+ else if (name === '--cache-dir')
102
+ parsed.cacheDir = r.value;
103
+ else if (name === '--state-dir')
104
+ parsed.stateDir = r.value;
105
+ else if (name === '--cap') {
106
+ const n = intFlag(r.value, '--cap');
107
+ if (typeof n !== 'number')
108
+ return { error: n.error };
109
+ parsed.cap = n;
110
+ }
111
+ else if (name === '--max-agents') {
112
+ const n = intFlag(r.value, '--max-agents');
113
+ if (typeof n !== 'number')
114
+ return { error: n.error };
115
+ parsed.maxAgents = n;
116
+ }
117
+ else if (name === '--poll-interval') {
118
+ const n = intFlag(r.value, '--poll-interval');
119
+ if (typeof n !== 'number')
120
+ return { error: n.error };
121
+ parsed.pollIntervalMs = n;
122
+ }
123
+ break;
124
+ }
125
+ default:
126
+ return { error: `unknown option '${a}'` };
127
+ }
128
+ }
129
+ return parsed;
130
+ }
131
+ function usage() {
132
+ process.stderr.write('usage: owenloop work shift [--origin <url>] [--as <account>] [--name <n>] [--serve-crews a,b] [--cap <n>]\n' +
133
+ ' [--workflow <id>] [--poll-interval <ms>] [--once]\n' +
134
+ ' [--max-agents <n>] [--cache-dir <p>] [--state-dir <p>]\n');
135
+ }
136
+ function errMsg(err) {
137
+ return err instanceof Error ? err.message : String(err);
138
+ }
139
+ /**
140
+ * Shared runtime setup for the internal shift and public shift daemon.
141
+ * `parsed` is already grammar-validated by the caller; this function owns all
142
+ * credential/settings/cache/spawner resolution so the two entry points cannot
143
+ * drift.
144
+ */
145
+ export async function runShiftRuntime(parsed, options = {}) {
146
+ const daemonMode = options.daemon === true;
147
+ const roleLabel = options.role === 'shift' ? 'owenloop shift' : 'owenloop work shift';
148
+ const env = process.env;
149
+ let settings;
150
+ try {
151
+ settings = loadSettings(env);
152
+ }
153
+ catch (err) {
154
+ process.stderr.write(`${roleLabel}: ${errMsg(err)}\n`);
155
+ return 1;
156
+ }
157
+ const origin = parsed.origin ?? settings.hubOrigin;
158
+ if (origin === undefined || origin.trim() === '') {
159
+ process.stderr.write(`${roleLabel}: no hub origin — pass --origin <url> or set hubOrigin in settings\n`);
160
+ return 2;
161
+ }
162
+ if (parsed.as !== undefined && parsed.as.trim() === '') {
163
+ process.stderr.write(`${roleLabel}: --as requires a non-empty account name\n`);
164
+ return 2;
165
+ }
166
+ const account = parsed.as ?? 'default';
167
+ const bearer = await resolveBearer({ origin, account, env });
168
+ if (!bearer.ok) {
169
+ process.stderr.write(`${roleLabel}: ${bearer.message}\n`);
170
+ return bearer.code;
171
+ }
172
+ const token = bearer.token;
173
+ let cacheDir;
174
+ let stateDir;
175
+ try {
176
+ cacheDir = parsed.cacheDir ?? resolveCacheDir(env, settings.cacheDir);
177
+ stateDir = resolveStateDir(env, resolveStateDirOverride(parsed.stateDir, env, settings.stateDir));
178
+ }
179
+ catch (err) {
180
+ process.stderr.write(`${roleLabel}: ${errMsg(err)}\n`);
181
+ return 1;
182
+ }
183
+ ensureStateDir(stateDir);
184
+ {
185
+ const liveRunIds = new Set(reconcileInFlight(stateDir).live.filter((r) => r.kind === 'agent-run').map((r) => r.run));
186
+ try {
187
+ const retired = reconcileActiveSessions(sessionsPath(cacheDir), liveRunIds, Date.now());
188
+ for (const rec of retired) {
189
+ process.stderr.write(`${roleLabel}: retired orphaned session ${rec.workflow}/${rec.run} step '${rec.step}' ` +
190
+ `(harness '${rec.harness}', attempt ${String(rec.attempt ?? 1)}) — its worker is gone, ` +
191
+ 'so the next attempt replays cold\n');
192
+ }
193
+ }
194
+ catch (err) {
195
+ process.stderr.write(`${roleLabel}: session reconcile failed (continuing): ${errMsg(err)}\n`);
196
+ }
197
+ }
198
+ const cap = resolveCap(parsed.cap, settings.dispatchCap);
199
+ const maxConcurrentAgents = resolveMaxConcurrentAgents(parsed.maxAgents, settings.maxConcurrentAgents);
200
+ const workRoot = resolveWorkRoot(env, settings.workRoot, cacheDir);
201
+ const workRepo = resolveWorkRepo(env, settings.workRepo);
202
+ const hub = createHubClient({ origin, getToken: async () => token });
203
+ const now = () => Date.now();
204
+ const shiftId = `shf_${randomUUID()}`;
205
+ const startedAt = now();
206
+ const name = resolveShiftName(parsed.name, { shiftId });
207
+ const spawner = createDefaultSpawner(origin, account, undefined, shiftId);
208
+ const pollIntervalMs = parsed.pollIntervalMs ?? DEFAULT_POLL_MS;
209
+ let daemon;
210
+ const loop = createShiftLoop({
211
+ hub,
212
+ spawner,
213
+ sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
214
+ now,
215
+ out: (line) => process.stdout.write(`${line}\n`),
216
+ err: (line) => process.stderr.write(`${line}\n`),
217
+ ...(daemonMode ? { onEvent: (event) => daemon?.onEvent(event) } : {}),
218
+ cacheDir,
219
+ stateDir,
220
+ cap,
221
+ serveCrews: parsed.serveCrews ?? [],
222
+ name,
223
+ commandRouting: settings.commandRouting,
224
+ pollIntervalMs,
225
+ presenceIntervalMs: DEFAULT_PRESENCE_MS,
226
+ maxConcurrentAgents,
227
+ workRoot,
228
+ ...(workRepo !== undefined ? { workRepo } : {}),
229
+ shiftId,
230
+ startedAt,
231
+ ...(parsed.workflow !== undefined ? { workflow: parsed.workflow } : {}),
232
+ ...(parsed.once === true ? { once: true } : {}),
233
+ });
234
+ if (daemonMode) {
235
+ daemon = createShiftDaemon({
236
+ socketPath: options.socketPath ?? join(stateDir, 'shift.sock'),
237
+ stateDir,
238
+ loop,
239
+ hub,
240
+ now,
241
+ startedAt,
242
+ shiftId,
243
+ err: (line) => process.stderr.write(`${line}\n`),
244
+ });
245
+ installSignalHandlers(daemon, process, (line) => process.stderr.write(`${line}\n`), {
246
+ role: 'shift',
247
+ drainNote: 'draining, in-flight children keep running',
248
+ stopReason: 'signal',
249
+ });
250
+ if (parsed.once !== true) {
251
+ process.stdout.write(`owenloop shift: parked as '${name}' @ ${origin} (cap ${cap})\n`);
252
+ }
253
+ return daemon.run();
254
+ }
255
+ installSignalHandlers(loop, process, (line) => process.stderr.write(`${line}\n`));
256
+ if (parsed.once !== true) {
257
+ process.stdout.write(`owenloop work shift: parked as '${name}' @ ${origin} (cap ${cap})\n`);
258
+ }
259
+ return loop.run();
260
+ }
261
+ export async function run(args) {
262
+ const parsed = parseArgs(args);
263
+ if (parsed.error !== undefined) {
264
+ process.stderr.write(`owenloop work shift: ${parsed.error}\n`);
265
+ usage();
266
+ return 2;
267
+ }
268
+ if (args.some((arg) => arg === '--mcp' || arg.startsWith('--mcp='))) {
269
+ process.stderr.write('owenloop work shift: unknown option \'--mcp\'\n');
270
+ usage();
271
+ return 2;
272
+ }
273
+ return runShiftRuntime(parsed);
274
+ }
@@ -0,0 +1,23 @@
1
+ import type { HubClient } from '../hub/client.ts';
2
+ import type { ShiftLoop } from '../shift/loop.ts';
3
+ import { type ShiftEvent, type ShiftStatus } from './protocol.ts';
4
+ export interface ShiftDaemonOptions {
5
+ socketPath: string;
6
+ stateDir: string;
7
+ loop: ShiftLoop;
8
+ hub: HubClient;
9
+ now: () => number;
10
+ startedAt: number;
11
+ shiftId?: string;
12
+ err: (line: string) => void;
13
+ }
14
+ export interface ShiftDaemon {
15
+ run(): Promise<number>;
16
+ /** Stop the daemon. `end` performs the final attendance-clearing ping. */
17
+ stop(reason?: 'end' | 'signal' | 'loop'): void;
18
+ status(): ShiftStatus;
19
+ /** Callback passed into createShiftLoop for local dispatch observations. */
20
+ onEvent(event: ShiftEvent): void;
21
+ socketPath: string;
22
+ }
23
+ export declare function createShiftDaemon(opts: ShiftDaemonOptions): ShiftDaemon;