pi-thread-engine 0.4.2 → 0.4.3
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/PLAN.md +28 -43
- package/extensions/index.ts +699 -666
- package/package.json +1 -1
- package/src/dashboard.ts +393 -393
package/extensions/index.ts
CHANGED
|
@@ -1,666 +1,699 @@
|
|
|
1
|
-
import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
-
import { Type, type TUnsafe } from "@sinclair/typebox";
|
|
3
|
-
import { Text } from "@mariozechner/pi-tui";
|
|
4
|
-
|
|
5
|
-
// StringEnum helper (removed from pi-ai >=0.66)
|
|
6
|
-
function StringEnum<T extends readonly string[]>(
|
|
7
|
-
values: T,
|
|
8
|
-
options?: { description?: string; default?: T[number] },
|
|
9
|
-
): TUnsafe<T[number]> {
|
|
10
|
-
return Type.Unsafe<T[number]>({
|
|
11
|
-
type: "string",
|
|
12
|
-
enum: values as unknown as string[],
|
|
13
|
-
...(options?.description && { description: options.description }),
|
|
14
|
-
...(options?.default && { default: options.default }),
|
|
15
|
-
});
|
|
16
|
-
}
|
|
17
|
-
import { ThreadRegistry, formatElapsed } from "../src/core/registry.js";
|
|
18
|
-
import { ThreadExecutor } from "../src/core/executor.js";
|
|
19
|
-
import { createDashboard } from "../src/dashboard.js";
|
|
20
|
-
import type { Thread, ThreadType, Story, StoryPhase } from "../src/core/types.js";
|
|
21
|
-
|
|
22
|
-
export default function (pi: ExtensionAPI) {
|
|
23
|
-
const registry = new ThreadRegistry();
|
|
24
|
-
const executor = new ThreadExecutor(pi, registry);
|
|
25
|
-
|
|
26
|
-
// ── Session persistence ──────────────────────────────────────
|
|
27
|
-
// Persist thread/story state so it survives compaction and /fork
|
|
28
|
-
|
|
29
|
-
function persistState() {
|
|
30
|
-
const threads = registry.all().filter((t) => t.state !== "killed");
|
|
31
|
-
const stories = registry.allStories();
|
|
32
|
-
if (threads.length > 0 || stories.length > 0) {
|
|
33
|
-
pi.appendEntry("pi-threads-state", { threads, stories, timestamp: Date.now() });
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
// Save state on thread events
|
|
38
|
-
registry.on((event) => {
|
|
39
|
-
if (event.type === "thread_completed" || event.type === "thread_failed" ||
|
|
40
|
-
event.type === "story_completed" || event.type === "story_failed") {
|
|
41
|
-
persistState();
|
|
42
|
-
}
|
|
43
|
-
});
|
|
44
|
-
|
|
45
|
-
// Restore state on session start
|
|
46
|
-
pi.on("session_start", async (_event, ctx) => {
|
|
47
|
-
for (const entry of ctx.sessionManager.getEntries()) {
|
|
48
|
-
if (entry.type === "custom" && entry.customType === "pi-threads-state") {
|
|
49
|
-
const data = entry.data as { threads?: Thread[]; stories?: Story[]; timestamp?: number };
|
|
50
|
-
if (data?.threads) {
|
|
51
|
-
registry.restore(data.threads, data.stories ?? []);
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
});
|
|
56
|
-
|
|
57
|
-
// ── Status bar ───────────────────────────────────────────────
|
|
58
|
-
|
|
59
|
-
pi.on("session_start", async (_event, ctx) => {
|
|
60
|
-
registry.on(() => {
|
|
61
|
-
const running = registry.byState("running");
|
|
62
|
-
const stories = registry.allStories().filter((s) => s.state === "executing" || s.state === "planning");
|
|
63
|
-
const parts: string[] = [];
|
|
64
|
-
|
|
65
|
-
if (stories.length > 0) {
|
|
66
|
-
parts.push(`📖${stories.length}`);
|
|
67
|
-
}
|
|
68
|
-
if (running.length > 0) {
|
|
69
|
-
parts.push(
|
|
70
|
-
...running.map((t) => {
|
|
71
|
-
const sum = registry.summarize(t);
|
|
72
|
-
return `🧵${sum.type[0].toUpperCase()}:${sum.progress}`;
|
|
73
|
-
})
|
|
74
|
-
);
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
ctx.ui.setStatus("pi-threads", parts.length > 0 ? parts.join(" ") : undefined);
|
|
78
|
-
});
|
|
79
|
-
});
|
|
80
|
-
|
|
81
|
-
// ── Keyboard shortcut ────────────────────────────────────────
|
|
82
|
-
|
|
83
|
-
pi.registerShortcut("ctrl+shift+t", {
|
|
84
|
-
description: "Open thread dashboard",
|
|
85
|
-
handler: async (ctx) => {
|
|
86
|
-
// Trigger the /threads command
|
|
87
|
-
pi.sendUserMessage("/threads", { deliverAs: "followUp" });
|
|
88
|
-
},
|
|
89
|
-
});
|
|
90
|
-
|
|
91
|
-
// ── Helpers ──────────────────────────────────────────────────
|
|
92
|
-
|
|
93
|
-
function parseTaskArgs(args: string): string[] {
|
|
94
|
-
const tasks: string[] = [];
|
|
95
|
-
const re = /"([^"]+)"|'([^']+)'|(\S+)/g;
|
|
96
|
-
let m: RegExpExecArray | null;
|
|
97
|
-
while ((m = re.exec(args))) {
|
|
98
|
-
tasks.push(m[1] ?? m[2] ?? m[3]);
|
|
99
|
-
}
|
|
100
|
-
return tasks;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
function stateIcon(state: string): string {
|
|
104
|
-
switch (state) {
|
|
105
|
-
case "running": return "⟳";
|
|
106
|
-
case "completed": return "✓";
|
|
107
|
-
case "failed": return "✗";
|
|
108
|
-
case "killed": return "☠";
|
|
109
|
-
case "pending": return "·";
|
|
110
|
-
default: return "?";
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
function typeIcon(type: string): string {
|
|
115
|
-
switch (type) {
|
|
116
|
-
case "parallel": return "⫘";
|
|
117
|
-
case "chained": return "⟶";
|
|
118
|
-
case "fusion": return "⊕";
|
|
119
|
-
case "meta": return "◎";
|
|
120
|
-
case "long": return "∞";
|
|
121
|
-
case "zero": return "⊘";
|
|
122
|
-
default: return "·";
|
|
123
|
-
}
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
// ── /threads — unified TUI dashboard ─────────────────────────
|
|
127
|
-
|
|
128
|
-
pi.registerCommand("threads", {
|
|
129
|
-
description: "Thread dashboard — interactive TUI to view/manage threads and stories",
|
|
130
|
-
handler: async (args, ctx) => {
|
|
131
|
-
const subcmd = args?.trim().split(/\s+/)[0] ?? "";
|
|
132
|
-
const rest = args?.trim().slice(subcmd.length).trim() ?? "";
|
|
133
|
-
|
|
134
|
-
// Quick subcommands (no TUI)
|
|
135
|
-
if (subcmd === "kill" && rest) {
|
|
136
|
-
const t = registry.get(rest);
|
|
137
|
-
if (!t) { ctx.ui.notify(`Thread ${rest} not found`, "error"); return; }
|
|
138
|
-
registry.kill(rest);
|
|
139
|
-
ctx.ui.notify(`Killed ${rest}`, "warning");
|
|
140
|
-
return;
|
|
141
|
-
}
|
|
142
|
-
if (subcmd === "prune") {
|
|
143
|
-
registry.prune();
|
|
144
|
-
ctx.ui.notify("Pruned finished threads", "info");
|
|
145
|
-
return;
|
|
146
|
-
}
|
|
147
|
-
if (subcmd === "status") {
|
|
148
|
-
// Quick text status (no TUI)
|
|
149
|
-
const threads = registry.all();
|
|
150
|
-
const stories = registry.allStories();
|
|
151
|
-
if (threads.length === 0 && stories.length === 0) {
|
|
152
|
-
ctx.ui.notify("No active threads or stories.", "info");
|
|
153
|
-
return;
|
|
154
|
-
}
|
|
155
|
-
const lines: string[] = [];
|
|
156
|
-
for (const s of stories) {
|
|
157
|
-
const phases = s.phases.map((p) => `${stateIcon(p.state)}${p.name}`).join("→");
|
|
158
|
-
lines.push(`📖 ${s.id} [${s.state}] ${s.goal.slice(0, 50)} — ${phases}`);
|
|
159
|
-
}
|
|
160
|
-
for (const t of threads) {
|
|
161
|
-
const sum = registry.summarize(t);
|
|
162
|
-
lines.push(`🧵 ${sum.id} ${sum.type} [${sum.state}] ${sum.progress} (${sum.elapsed}) — ${sum.label}`);
|
|
163
|
-
}
|
|
164
|
-
ctx.ui.notify(lines.join("\n"), "info");
|
|
165
|
-
return;
|
|
166
|
-
}
|
|
167
|
-
if (subcmd === "review") {
|
|
168
|
-
const completed = registry.byState("completed");
|
|
169
|
-
if (completed.length === 0) { ctx.ui.notify("No completed threads to review", "info"); return; }
|
|
170
|
-
for (const t of completed) {
|
|
171
|
-
const lines: string[] = [`── Thread ${t.id} (${t.type}) ──`];
|
|
172
|
-
if (t.type === "fusion") {
|
|
173
|
-
lines.push("Fusion results — compare and pick the best:\n");
|
|
174
|
-
for (const tk of t.tasks) {
|
|
175
|
-
const modelTag = tk.model ? ` [${tk.model}]` : "";
|
|
176
|
-
lines.push(`═══ ${tk.id}${modelTag} (${tk.state}) ═══`);
|
|
177
|
-
lines.push(tk.result?.slice(0, 800) ?? tk.error ?? "(no output)");
|
|
178
|
-
lines.push("");
|
|
179
|
-
}
|
|
180
|
-
} else {
|
|
181
|
-
for (const tk of t.tasks) {
|
|
182
|
-
lines.push(` ${stateIcon(tk.state)} ${tk.id}: ${tk.label}`);
|
|
183
|
-
if (tk.result) lines.push(` ${tk.result.slice(0, 300)}`);
|
|
184
|
-
if (tk.error) lines.push(` ERROR: ${tk.error.slice(0, 200)}`);
|
|
185
|
-
}
|
|
186
|
-
}
|
|
187
|
-
ctx.ui.notify(lines.join("\n"), "info");
|
|
188
|
-
}
|
|
189
|
-
return;
|
|
190
|
-
}
|
|
191
|
-
|
|
192
|
-
//
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
}
|
|
243
|
-
});
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
},
|
|
278
|
-
});
|
|
279
|
-
|
|
280
|
-
// ── /
|
|
281
|
-
|
|
282
|
-
pi.registerCommand("
|
|
283
|
-
description:
|
|
284
|
-
handler: async (args, ctx) => {
|
|
285
|
-
if (!args?.trim()) { ctx.ui.notify(
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
}
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
}
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
});
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
if (
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
""
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
"
|
|
470
|
-
|
|
471
|
-
"",
|
|
472
|
-
|
|
473
|
-
]
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
const
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
const
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
})
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
}
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
if (
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
}
|
|
1
|
+
import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import { Type, type TUnsafe } from "@sinclair/typebox";
|
|
3
|
+
import { Text } from "@mariozechner/pi-tui";
|
|
4
|
+
|
|
5
|
+
// StringEnum helper (removed from pi-ai >=0.66)
|
|
6
|
+
function StringEnum<T extends readonly string[]>(
|
|
7
|
+
values: T,
|
|
8
|
+
options?: { description?: string; default?: T[number] },
|
|
9
|
+
): TUnsafe<T[number]> {
|
|
10
|
+
return Type.Unsafe<T[number]>({
|
|
11
|
+
type: "string",
|
|
12
|
+
enum: values as unknown as string[],
|
|
13
|
+
...(options?.description && { description: options.description }),
|
|
14
|
+
...(options?.default && { default: options.default }),
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
import { ThreadRegistry, formatElapsed } from "../src/core/registry.js";
|
|
18
|
+
import { ThreadExecutor } from "../src/core/executor.js";
|
|
19
|
+
import { createDashboard } from "../src/dashboard.js";
|
|
20
|
+
import type { Thread, ThreadType, Story, StoryPhase } from "../src/core/types.js";
|
|
21
|
+
|
|
22
|
+
export default function (pi: ExtensionAPI) {
|
|
23
|
+
const registry = new ThreadRegistry();
|
|
24
|
+
const executor = new ThreadExecutor(pi, registry);
|
|
25
|
+
|
|
26
|
+
// ── Session persistence ──────────────────────────────────────
|
|
27
|
+
// Persist thread/story state so it survives compaction and /fork
|
|
28
|
+
|
|
29
|
+
function persistState() {
|
|
30
|
+
const threads = registry.all().filter((t) => t.state !== "killed");
|
|
31
|
+
const stories = registry.allStories();
|
|
32
|
+
if (threads.length > 0 || stories.length > 0) {
|
|
33
|
+
pi.appendEntry("pi-threads-state", { threads, stories, timestamp: Date.now() });
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
// Save state on thread events
|
|
38
|
+
registry.on((event) => {
|
|
39
|
+
if (event.type === "thread_completed" || event.type === "thread_failed" ||
|
|
40
|
+
event.type === "story_completed" || event.type === "story_failed") {
|
|
41
|
+
persistState();
|
|
42
|
+
}
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
// Restore state on session start
|
|
46
|
+
pi.on("session_start", async (_event, ctx) => {
|
|
47
|
+
for (const entry of ctx.sessionManager.getEntries()) {
|
|
48
|
+
if (entry.type === "custom" && entry.customType === "pi-threads-state") {
|
|
49
|
+
const data = entry.data as { threads?: Thread[]; stories?: Story[]; timestamp?: number };
|
|
50
|
+
if (data?.threads) {
|
|
51
|
+
registry.restore(data.threads, data.stories ?? []);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
// ── Status bar ───────────────────────────────────────────────
|
|
58
|
+
|
|
59
|
+
pi.on("session_start", async (_event, ctx) => {
|
|
60
|
+
registry.on(() => {
|
|
61
|
+
const running = registry.byState("running");
|
|
62
|
+
const stories = registry.allStories().filter((s) => s.state === "executing" || s.state === "planning");
|
|
63
|
+
const parts: string[] = [];
|
|
64
|
+
|
|
65
|
+
if (stories.length > 0) {
|
|
66
|
+
parts.push(`📖${stories.length}`);
|
|
67
|
+
}
|
|
68
|
+
if (running.length > 0) {
|
|
69
|
+
parts.push(
|
|
70
|
+
...running.map((t) => {
|
|
71
|
+
const sum = registry.summarize(t);
|
|
72
|
+
return `🧵${sum.type[0].toUpperCase()}:${sum.progress}`;
|
|
73
|
+
})
|
|
74
|
+
);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
ctx.ui.setStatus("pi-threads", parts.length > 0 ? parts.join(" ") : undefined);
|
|
78
|
+
});
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
// ── Keyboard shortcut ────────────────────────────────────────
|
|
82
|
+
|
|
83
|
+
pi.registerShortcut("ctrl+shift+t", {
|
|
84
|
+
description: "Open thread dashboard",
|
|
85
|
+
handler: async (ctx) => {
|
|
86
|
+
// Trigger the /threads command
|
|
87
|
+
pi.sendUserMessage("/threads", { deliverAs: "followUp" });
|
|
88
|
+
},
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
// ── Helpers ──────────────────────────────────────────────────
|
|
92
|
+
|
|
93
|
+
function parseTaskArgs(args: string): string[] {
|
|
94
|
+
const tasks: string[] = [];
|
|
95
|
+
const re = /"([^"]+)"|'([^']+)'|(\S+)/g;
|
|
96
|
+
let m: RegExpExecArray | null;
|
|
97
|
+
while ((m = re.exec(args))) {
|
|
98
|
+
tasks.push(m[1] ?? m[2] ?? m[3]);
|
|
99
|
+
}
|
|
100
|
+
return tasks;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
function stateIcon(state: string): string {
|
|
104
|
+
switch (state) {
|
|
105
|
+
case "running": return "⟳";
|
|
106
|
+
case "completed": return "✓";
|
|
107
|
+
case "failed": return "✗";
|
|
108
|
+
case "killed": return "☠";
|
|
109
|
+
case "pending": return "·";
|
|
110
|
+
default: return "?";
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function typeIcon(type: string): string {
|
|
115
|
+
switch (type) {
|
|
116
|
+
case "parallel": return "⫘";
|
|
117
|
+
case "chained": return "⟶";
|
|
118
|
+
case "fusion": return "⊕";
|
|
119
|
+
case "meta": return "◎";
|
|
120
|
+
case "long": return "∞";
|
|
121
|
+
case "zero": return "⊘";
|
|
122
|
+
default: return "·";
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// ── /threads — unified TUI dashboard ─────────────────────────
|
|
127
|
+
|
|
128
|
+
pi.registerCommand("threads", {
|
|
129
|
+
description: "Thread dashboard — interactive TUI to view/manage threads and stories",
|
|
130
|
+
handler: async (args, ctx) => {
|
|
131
|
+
const subcmd = args?.trim().split(/\s+/)[0] ?? "";
|
|
132
|
+
const rest = args?.trim().slice(subcmd.length).trim() ?? "";
|
|
133
|
+
|
|
134
|
+
// Quick subcommands (no TUI)
|
|
135
|
+
if (subcmd === "kill" && rest) {
|
|
136
|
+
const t = registry.get(rest);
|
|
137
|
+
if (!t) { ctx.ui.notify(`Thread ${rest} not found`, "error"); return; }
|
|
138
|
+
registry.kill(rest);
|
|
139
|
+
ctx.ui.notify(`Killed ${rest}`, "warning");
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
if (subcmd === "prune") {
|
|
143
|
+
registry.prune();
|
|
144
|
+
ctx.ui.notify("Pruned finished threads", "info");
|
|
145
|
+
return;
|
|
146
|
+
}
|
|
147
|
+
if (subcmd === "status") {
|
|
148
|
+
// Quick text status (no TUI)
|
|
149
|
+
const threads = registry.all();
|
|
150
|
+
const stories = registry.allStories();
|
|
151
|
+
if (threads.length === 0 && stories.length === 0) {
|
|
152
|
+
ctx.ui.notify("No active threads or stories.", "info");
|
|
153
|
+
return;
|
|
154
|
+
}
|
|
155
|
+
const lines: string[] = [];
|
|
156
|
+
for (const s of stories) {
|
|
157
|
+
const phases = s.phases.map((p) => `${stateIcon(p.state)}${p.name}`).join("→");
|
|
158
|
+
lines.push(`📖 ${s.id} [${s.state}] ${s.goal.slice(0, 50)} — ${phases}`);
|
|
159
|
+
}
|
|
160
|
+
for (const t of threads) {
|
|
161
|
+
const sum = registry.summarize(t);
|
|
162
|
+
lines.push(`🧵 ${sum.id} ${sum.type} [${sum.state}] ${sum.progress} (${sum.elapsed}) — ${sum.label}`);
|
|
163
|
+
}
|
|
164
|
+
ctx.ui.notify(lines.join("\n"), "info");
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
if (subcmd === "review") {
|
|
168
|
+
const completed = registry.byState("completed");
|
|
169
|
+
if (completed.length === 0) { ctx.ui.notify("No completed threads to review", "info"); return; }
|
|
170
|
+
for (const t of completed) {
|
|
171
|
+
const lines: string[] = [`── Thread ${t.id} (${t.type}) ──`];
|
|
172
|
+
if (t.type === "fusion") {
|
|
173
|
+
lines.push("Fusion results — compare and pick the best:\n");
|
|
174
|
+
for (const tk of t.tasks) {
|
|
175
|
+
const modelTag = tk.model ? ` [${tk.model}]` : "";
|
|
176
|
+
lines.push(`═══ ${tk.id}${modelTag} (${tk.state}) ═══`);
|
|
177
|
+
lines.push(tk.result?.slice(0, 800) ?? tk.error ?? "(no output)");
|
|
178
|
+
lines.push("");
|
|
179
|
+
}
|
|
180
|
+
} else {
|
|
181
|
+
for (const tk of t.tasks) {
|
|
182
|
+
lines.push(` ${stateIcon(tk.state)} ${tk.id}: ${tk.label}`);
|
|
183
|
+
if (tk.result) lines.push(` ${tk.result.slice(0, 300)}`);
|
|
184
|
+
if (tk.error) lines.push(` ERROR: ${tk.error.slice(0, 200)}`);
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
ctx.ui.notify(lines.join("\n"), "info");
|
|
188
|
+
}
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
// ── /threads export ──
|
|
193
|
+
if (subcmd === "export") {
|
|
194
|
+
const exportAll = rest === "--all" || rest === "-a";
|
|
195
|
+
const exportId = !exportAll && rest ? rest : null;
|
|
196
|
+
const src = exportAll ? registry.all() : exportId ? [registry.get(exportId)].filter(Boolean) : [];
|
|
197
|
+
const stSrc = exportAll ? registry.allStories() : exportId ? [registry.getStory(exportId)].filter(Boolean) : [];
|
|
198
|
+
if (src.length === 0 && stSrc.length === 0) {
|
|
199
|
+
ctx.ui.notify("Nothing to export", "info");
|
|
200
|
+
return;
|
|
201
|
+
}
|
|
202
|
+
const md = ["# pi-thread-engine Export", ""];
|
|
203
|
+
for (const s of stSrc) {
|
|
204
|
+
md.push("## Story: " + s.id);
|
|
205
|
+
md.push("Goal: " + s.goal);
|
|
206
|
+
md.push("State: " + s.state);
|
|
207
|
+
}
|
|
208
|
+
for (const t of src) {
|
|
209
|
+
const sum = registry.summarize(t);
|
|
210
|
+
md.push("## " + sum.id + ": " + sum.type);
|
|
211
|
+
md.push("Label: " + sum.label);
|
|
212
|
+
md.push("State: " + sum.state);
|
|
213
|
+
for (const tk of t.tasks) {
|
|
214
|
+
md.push("- " + tk.id + " [" + tk.state + "]: " + (tk.result ? tk.result.slice(0, 200) : tk.error ? "ERROR: " + tk.error.slice(0, 200) : "(no result)"));
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
const ts = new Date().toISOString().slice(0, 19).replace(/[T:]/g, "-");
|
|
218
|
+
const fn = "threads-" + ts + ".md";
|
|
219
|
+
const outPath = require("path").join(ctx.cwd, fn);
|
|
220
|
+
require("fs").writeFileSync(outPath, md.join("\n"), "utf8");
|
|
221
|
+
ctx.ui.notify("Exported to " + outPath, "info");
|
|
222
|
+
return;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
// Default: open interactive TUI dashboard
|
|
226
|
+
// ── /agents alias (Claude-style muscle memory) ──────────────
|
|
227
|
+
pi.registerCommand("agents", {
|
|
228
|
+
description: "Alias for /threads — Claude-style Agent View dashboard",
|
|
229
|
+
handler: async (a, c) => {
|
|
230
|
+
// Forward to /threads
|
|
231
|
+
await ctx.ui.custom<void>((tui, theme, _kb, done) => {
|
|
232
|
+
const dashboard = createDashboard(
|
|
233
|
+
registry,
|
|
234
|
+
theme,
|
|
235
|
+
() => done(),
|
|
236
|
+
(id) => { registry.kill(id); ctx.ui.notify(`Killed ${id}`, "warning"); tui.requestRender(); },
|
|
237
|
+
(id) => { const t = registry.get(id); if (t) { ctx.ui.notify(`Thread ${id}: ${t.tasks.map((tk) => `${tk.id}: ${tk.result?.slice(0,100) ?? tk.error ?? "(pending)"}`).join("\n")}`, "info"); } },
|
|
238
|
+
(id, message) => { executor.injectReply(id, message); ctx.ui.notify(`Replied to ${id}: ${message.slice(0, 50)}...`, "info"); tui.requestRender(); }
|
|
239
|
+
);
|
|
240
|
+
return { render: (w: number) => dashboard.render(w), invalidate: () => dashboard.invalidate(), handleInput: (data: string) => { dashboard.handleInput(data); tui.requestRender(); } };
|
|
241
|
+
});
|
|
242
|
+
},
|
|
243
|
+
});
|
|
244
|
+
// ── End /agents alias ───────────────────────────────────────
|
|
245
|
+
|
|
246
|
+
await ctx.ui.custom<void>((tui, theme, _kb, done) => {
|
|
247
|
+
const dashboard = createDashboard(
|
|
248
|
+
registry,
|
|
249
|
+
theme,
|
|
250
|
+
() => done(),
|
|
251
|
+
(id) => {
|
|
252
|
+
registry.kill(id);
|
|
253
|
+
ctx.ui.notify(`Killed ${id}`, "warning");
|
|
254
|
+
tui.requestRender();
|
|
255
|
+
},
|
|
256
|
+
(id) => {
|
|
257
|
+
const t = registry.get(id);
|
|
258
|
+
if (t) {
|
|
259
|
+
const preview = t.tasks.map((tk) => `${tk.id}: ${tk.result?.slice(0, 100) ?? tk.error ?? "(pending)"}`).join("\n");
|
|
260
|
+
ctx.ui.notify(`Thread ${id} results:\n${preview}`, "info");
|
|
261
|
+
}
|
|
262
|
+
},
|
|
263
|
+
(id, message) => {
|
|
264
|
+
// Inline reply — send message to blocked thread
|
|
265
|
+
executor.injectReply(id, message);
|
|
266
|
+
ctx.ui.notify(`Replied to ${id}: ${message.slice(0, 50)}...`, "info");
|
|
267
|
+
tui.requestRender();
|
|
268
|
+
}
|
|
269
|
+
);
|
|
270
|
+
|
|
271
|
+
return {
|
|
272
|
+
render: (w: number) => dashboard.render(w),
|
|
273
|
+
invalidate: () => dashboard.invalidate(),
|
|
274
|
+
handleInput: (data: string) => { dashboard.handleInput(data); tui.requestRender(); },
|
|
275
|
+
};
|
|
276
|
+
});
|
|
277
|
+
},
|
|
278
|
+
});
|
|
279
|
+
|
|
280
|
+
// ── /pthread — parallel via subagent ─────────────────────────
|
|
281
|
+
|
|
282
|
+
pi.registerCommand("pthread", {
|
|
283
|
+
description: 'P-Thread: run N tasks in parallel via subagent. Usage: /pthread "task 1" "task 2" "task 3"',
|
|
284
|
+
handler: async (args, ctx) => {
|
|
285
|
+
if (!args?.trim()) { ctx.ui.notify('Usage: /pthread "task 1" "task 2"', "error"); return; }
|
|
286
|
+
const tasks = parseTaskArgs(args);
|
|
287
|
+
if (tasks.length === 0) { ctx.ui.notify("No tasks specified", "error"); return; }
|
|
288
|
+
|
|
289
|
+
const label = tasks.length === 1 ? tasks[0] : `${tasks.length} parallel tasks`;
|
|
290
|
+
const thread = registry.create("parallel", label, tasks, { cwd: ctx.cwd, backend: "subagent" });
|
|
291
|
+
|
|
292
|
+
ctx.ui.notify(`🧵 P-Thread ${thread.id}: Dispatching ${tasks.length} task(s) via subagent...`, "info");
|
|
293
|
+
executor.dispatch(thread);
|
|
294
|
+
},
|
|
295
|
+
});
|
|
296
|
+
|
|
297
|
+
// ── /cthread — chained via subagent ──────────────────────────
|
|
298
|
+
|
|
299
|
+
pi.registerCommand("cthread", {
|
|
300
|
+
description: 'C-Thread: sequential phases via subagent chain. Usage: /cthread "phase 1" "phase 2"',
|
|
301
|
+
handler: async (args, ctx) => {
|
|
302
|
+
if (!args?.trim()) { ctx.ui.notify('Usage: /cthread "phase 1" "phase 2"', "error"); return; }
|
|
303
|
+
const phases = parseTaskArgs(args);
|
|
304
|
+
if (phases.length < 2) { ctx.ui.notify("Need at least 2 phases", "error"); return; }
|
|
305
|
+
|
|
306
|
+
const thread = registry.create("chained", `Chain: ${phases.length} phases`, phases, { cwd: ctx.cwd, backend: "subagent" });
|
|
307
|
+
|
|
308
|
+
ctx.ui.notify(`🧵 C-Thread ${thread.id}: ${phases.length} phases via subagent chain...`, "info");
|
|
309
|
+
executor.dispatch(thread);
|
|
310
|
+
},
|
|
311
|
+
});
|
|
312
|
+
|
|
313
|
+
// ── /bthread — meta via subagent (scout→plan→build→review) ──
|
|
314
|
+
|
|
315
|
+
pi.registerCommand("bthread", {
|
|
316
|
+
description: "B-Thread: scout → plan → build → review via subagent. Usage: /bthread <goal>",
|
|
317
|
+
handler: async (args, ctx) => {
|
|
318
|
+
if (!args?.trim()) { ctx.ui.notify("Usage: /bthread <goal>", "error"); return; }
|
|
319
|
+
|
|
320
|
+
const thread = registry.create("meta", `Meta: ${args.slice(0, 40)}`, [args.trim()], { cwd: ctx.cwd, backend: "subagent" });
|
|
321
|
+
|
|
322
|
+
ctx.ui.notify(`🧵 B-Thread ${thread.id}: scout → plan → build → review...`, "info");
|
|
323
|
+
executor.dispatch(thread);
|
|
324
|
+
},
|
|
325
|
+
});
|
|
326
|
+
|
|
327
|
+
// ── /fthread — FUSION (native, multi-model) ──────────────────
|
|
328
|
+
// This is unique to pi-threads — no other extension does this
|
|
329
|
+
|
|
330
|
+
pi.registerCommand("fthread", {
|
|
331
|
+
description: 'F-Thread: same prompt to N agents/models, compare results. Usage: /fthread "prompt" [--count N] [--models m1,m2,m3]',
|
|
332
|
+
handler: async (args, ctx) => {
|
|
333
|
+
if (!args?.trim()) {
|
|
334
|
+
ctx.ui.notify('Usage: /fthread "prompt" [--count 3] [--models sonnet,gemini,gpt]', "error");
|
|
335
|
+
return;
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
let count = 3;
|
|
339
|
+
let models: string[] | undefined;
|
|
340
|
+
let prompt = args;
|
|
341
|
+
|
|
342
|
+
const countMatch = args.match(/--count\s+(\d+)/);
|
|
343
|
+
if (countMatch) {
|
|
344
|
+
count = parseInt(countMatch[1]);
|
|
345
|
+
prompt = prompt.replace(countMatch[0], "").trim();
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
const modelsMatch = args.match(/--models\s+([\w/,.:@-]+)/);
|
|
349
|
+
if (modelsMatch) {
|
|
350
|
+
models = modelsMatch[1].split(",");
|
|
351
|
+
count = models.length;
|
|
352
|
+
prompt = prompt.replace(modelsMatch[0], "").trim();
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
prompt = prompt.replace(/^["']|["']$/g, "").trim();
|
|
356
|
+
if (!prompt) { ctx.ui.notify("No prompt specified", "error"); return; }
|
|
357
|
+
|
|
358
|
+
const prompts = Array(count).fill(prompt);
|
|
359
|
+
const modelList = models ?? Array(count).fill(undefined);
|
|
360
|
+
const thread = registry.create("fusion", `Fusion: ${prompt.slice(0, 40)}`, prompts, {
|
|
361
|
+
models: modelList,
|
|
362
|
+
cwd: ctx.cwd,
|
|
363
|
+
backend: "native",
|
|
364
|
+
});
|
|
365
|
+
|
|
366
|
+
const modelDesc = models ? models.join(", ") : `${count} agents (same model)`;
|
|
367
|
+
ctx.ui.notify(`🧵 F-Thread ${thread.id}: "${prompt.slice(0, 50)}" → ${modelDesc}`, "info");
|
|
368
|
+
|
|
369
|
+
// Fusion runs natively — fire and forget
|
|
370
|
+
executor.dispatch(thread).then(() => {
|
|
371
|
+
if (thread.state === "completed") {
|
|
372
|
+
ctx.ui.notify(`✅ F-Thread ${thread.id} done! ${count} results. Use /threads review`, "info");
|
|
373
|
+
} else {
|
|
374
|
+
ctx.ui.notify(`❌ F-Thread ${thread.id} ${thread.state}`, "error");
|
|
375
|
+
}
|
|
376
|
+
});
|
|
377
|
+
},
|
|
378
|
+
});
|
|
379
|
+
|
|
380
|
+
// ── /zthread — ZERO-TOUCH (native + verification) ────────────
|
|
381
|
+
// Unique to pi-threads — autonomous with verify gate
|
|
382
|
+
|
|
383
|
+
pi.registerCommand("zthread", {
|
|
384
|
+
description: 'Z-Thread: autonomous + verify. Usage: /zthread "prompt" --verify "npm test"',
|
|
385
|
+
handler: async (args, ctx) => {
|
|
386
|
+
if (!args?.trim()) {
|
|
387
|
+
ctx.ui.notify('Usage: /zthread "prompt" --verify "npm test"', "error");
|
|
388
|
+
return;
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
let prompt = args;
|
|
392
|
+
let verifyCommand: string | undefined;
|
|
393
|
+
|
|
394
|
+
const verifyMatch = args.match(/--verify\s+"([^"]+)"|--verify\s+'([^']+)'|--verify\s+(\S+)/);
|
|
395
|
+
if (verifyMatch) {
|
|
396
|
+
verifyCommand = verifyMatch[1] ?? verifyMatch[2] ?? verifyMatch[3];
|
|
397
|
+
prompt = prompt.replace(verifyMatch[0], "").trim();
|
|
398
|
+
}
|
|
399
|
+
prompt = prompt.replace(/^["']|["']$/g, "").trim();
|
|
400
|
+
|
|
401
|
+
const thread = registry.create("zero", `Zero: ${prompt.slice(0, 40)}`, [prompt], {
|
|
402
|
+
cwd: ctx.cwd,
|
|
403
|
+
backend: "native",
|
|
404
|
+
verify: verifyCommand,
|
|
405
|
+
});
|
|
406
|
+
|
|
407
|
+
const verifyDesc = verifyCommand ? ` → verify: ${verifyCommand}` : "";
|
|
408
|
+
ctx.ui.notify(`🧵 Z-Thread ${thread.id}: "${prompt.slice(0, 50)}"${verifyDesc}`, "info");
|
|
409
|
+
|
|
410
|
+
executor.dispatch(thread).then(() => {
|
|
411
|
+
if (thread.state === "completed") {
|
|
412
|
+
ctx.ui.notify(`✅ Z-Thread ${thread.id} shipped!${verifyCommand ? " ✓ Verification passed." : ""}`, "info");
|
|
413
|
+
} else {
|
|
414
|
+
const err = thread.tasks[0]?.error ?? "unknown error";
|
|
415
|
+
ctx.ui.notify(`❌ Z-Thread ${thread.id} failed: ${err.slice(0, 150)}`, "error");
|
|
416
|
+
}
|
|
417
|
+
});
|
|
418
|
+
},
|
|
419
|
+
});
|
|
420
|
+
|
|
421
|
+
// ── /lthread — long-running (native) ─────────────────────────
|
|
422
|
+
|
|
423
|
+
pi.registerCommand("lthread", {
|
|
424
|
+
description: "L-Thread: extended autonomous run. Usage: /lthread <prompt>",
|
|
425
|
+
handler: async (args, ctx) => {
|
|
426
|
+
if (!args?.trim()) { ctx.ui.notify("Usage: /lthread <prompt>", "error"); return; }
|
|
427
|
+
|
|
428
|
+
const thread = registry.create("long", `Long: ${args.slice(0, 40)}`, [args.trim()], {
|
|
429
|
+
cwd: ctx.cwd,
|
|
430
|
+
backend: "native",
|
|
431
|
+
});
|
|
432
|
+
|
|
433
|
+
ctx.ui.notify(`🧵 L-Thread ${thread.id}: Extended run starting...`, "info");
|
|
434
|
+
|
|
435
|
+
executor.dispatch(thread).then(() => {
|
|
436
|
+
if (thread.state === "completed") {
|
|
437
|
+
ctx.ui.notify(`✅ L-Thread ${thread.id} done!`, "info");
|
|
438
|
+
} else {
|
|
439
|
+
ctx.ui.notify(`❌ L-Thread ${thread.id} ${thread.state}`, "error");
|
|
440
|
+
}
|
|
441
|
+
});
|
|
442
|
+
},
|
|
443
|
+
});
|
|
444
|
+
|
|
445
|
+
// ── /story — STORIES (the unique layer) ──────────────────────
|
|
446
|
+
|
|
447
|
+
pi.registerCommand("story", {
|
|
448
|
+
description: 'Story mode: auto-decompose goal into thread phases. Usage: /story "Add dark mode" [--verify "npm test"]',
|
|
449
|
+
handler: async (args, ctx) => {
|
|
450
|
+
if (!args?.trim()) {
|
|
451
|
+
ctx.ui.notify('Usage: /story "goal" [--verify "npm test"]', "error");
|
|
452
|
+
return;
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
// Parse verify flag
|
|
456
|
+
let goal = args;
|
|
457
|
+
let verify: string | undefined;
|
|
458
|
+
const verifyMatch = args.match(/--verify\s+"([^"]+)"|--verify\s+'([^']+)'|--verify\s+(\S+)/);
|
|
459
|
+
if (verifyMatch) {
|
|
460
|
+
verify = verifyMatch[1] ?? verifyMatch[2] ?? verifyMatch[3];
|
|
461
|
+
goal = goal.replace(verifyMatch[0], "").trim();
|
|
462
|
+
}
|
|
463
|
+
goal = goal.replace(/^["']|["']$/g, "").trim();
|
|
464
|
+
|
|
465
|
+
const story = registry.createStory(goal, verify);
|
|
466
|
+
|
|
467
|
+
// Auto-decompose into phases
|
|
468
|
+
const phases: StoryPhase[] = [
|
|
469
|
+
{ name: "scout", threadType: "meta", state: "pending", description: `Research: ${goal}` },
|
|
470
|
+
{ name: "plan", threadType: "fusion", state: "pending", description: `3 models brainstorm approaches for: ${goal}` },
|
|
471
|
+
{ name: "decide", threadType: "chained", state: "pending", description: "Human picks the best approach" },
|
|
472
|
+
{ name: "build", threadType: "parallel", state: "pending", description: `Implement: ${goal}` },
|
|
473
|
+
];
|
|
474
|
+
|
|
475
|
+
if (verify) {
|
|
476
|
+
phases.push({ name: "verify", threadType: "zero", state: "pending", description: `Verify: ${verify}` });
|
|
477
|
+
}
|
|
478
|
+
|
|
479
|
+
for (const p of phases) {
|
|
480
|
+
registry.addPhase(story.id, p);
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
const phaseNames = phases.map((p) => p.name).join(" → ");
|
|
484
|
+
ctx.ui.notify(`📖 Story ${story.id}: "${goal.slice(0, 50)}"\n Phases: ${phaseNames}`, "info");
|
|
485
|
+
|
|
486
|
+
// Start with the scout phase — send it to the LLM to execute
|
|
487
|
+
registry.startPhase(story.id, 0, "pending");
|
|
488
|
+
|
|
489
|
+
// The story orchestration happens via the LLM — we give it the plan
|
|
490
|
+
const storyPrompt = [
|
|
491
|
+
`## Story ${story.id}: ${goal}`,
|
|
492
|
+
"",
|
|
493
|
+
"Execute this story phase by phase. Use the thread tools.",
|
|
494
|
+
"",
|
|
495
|
+
"### Phases:",
|
|
496
|
+
...phases.map((p, i) => `${i + 1}. **${p.name}** (${p.threadType}): ${p.description}`),
|
|
497
|
+
"",
|
|
498
|
+
"### Instructions:",
|
|
499
|
+
"1. Start with phase 1 (scout) — use `thread_spawn` with type 'meta'",
|
|
500
|
+
"2. For phase 2 (plan), use `thread_spawn` with type 'fusion' and --models if available",
|
|
501
|
+
"3. Present the fusion results to the user for phase 3 (decide)",
|
|
502
|
+
"4. Execute phase 4 (build) based on the chosen approach",
|
|
503
|
+
verify ? `5. Run verification: \`${verify}\`` : "",
|
|
504
|
+
"",
|
|
505
|
+
"Check progress with `thread_status`. Report when done.",
|
|
506
|
+
].filter(Boolean).join("\n");
|
|
507
|
+
|
|
508
|
+
pi.sendUserMessage(storyPrompt, { deliverAs: "followUp" });
|
|
509
|
+
},
|
|
510
|
+
});
|
|
511
|
+
|
|
512
|
+
// ── /stories — list stories ──────────────────────────────────
|
|
513
|
+
|
|
514
|
+
pi.registerCommand("stories", {
|
|
515
|
+
description: "List all stories",
|
|
516
|
+
handler: async (_args, ctx) => {
|
|
517
|
+
const stories = registry.allStories();
|
|
518
|
+
if (stories.length === 0) {
|
|
519
|
+
ctx.ui.notify("No stories. Use /story to start one.", "info");
|
|
520
|
+
return;
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
const lines: string[] = ["📖 Stories", ""];
|
|
524
|
+
for (const s of stories) {
|
|
525
|
+
const phases = s.phases.map((p) => `${stateIcon(p.state)}${p.name}`).join(" → ");
|
|
526
|
+
lines.push(` ${s.id} [${s.state}] ${s.goal.slice(0, 60)}`);
|
|
527
|
+
lines.push(` ${phases}`);
|
|
528
|
+
}
|
|
529
|
+
ctx.ui.notify(lines.join("\n"), "info");
|
|
530
|
+
},
|
|
531
|
+
});
|
|
532
|
+
|
|
533
|
+
// ── LLM-callable tools ───────────────────────────────────────
|
|
534
|
+
|
|
535
|
+
pi.registerTool({
|
|
536
|
+
name: "thread_spawn",
|
|
537
|
+
label: "Thread Spawn",
|
|
538
|
+
description: [
|
|
539
|
+
"Spawn a thread. Types:",
|
|
540
|
+
"- parallel: N independent tasks in parallel (via subagent)",
|
|
541
|
+
"- chained: sequential phases with checkpoints (via subagent)",
|
|
542
|
+
"- meta: scout→plan→build→review pipeline (via subagent)",
|
|
543
|
+
"- fusion: same prompt to N agents/models, compare results (native, UNIQUE)",
|
|
544
|
+
"- zero: autonomous + verification command gate (native, UNIQUE)",
|
|
545
|
+
"- long: extended autonomous run (native)",
|
|
546
|
+
].join("\n"),
|
|
547
|
+
parameters: Type.Object({
|
|
548
|
+
type: StringEnum(["parallel", "fusion", "chained", "meta", "long", "zero"] as const),
|
|
549
|
+
prompts: Type.Array(Type.String(), { description: "Task prompts" }),
|
|
550
|
+
models: Type.Optional(Type.Array(Type.String(), { description: "Models for fusion (e.g. ['anthropic/claude-sonnet-4', 'google/gemini-2.5-pro'])" })),
|
|
551
|
+
count: Type.Optional(Type.Number({ description: "Agent count for fusion (default 3)" })),
|
|
552
|
+
verify: Type.Optional(Type.String({ description: "Verification command for zero-touch (e.g. 'npm test')" })),
|
|
553
|
+
agent: Type.Optional(Type.String({ description: "Subagent agent name (default: worker)" })),
|
|
554
|
+
backend: Type.Optional(StringEnum(["subagent", "native"] as const)),
|
|
555
|
+
}),
|
|
556
|
+
async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
|
|
557
|
+
const { type, prompts, models, count, verify, agent, backend: backendOverride } = params;
|
|
558
|
+
let taskPrompts = prompts;
|
|
559
|
+
|
|
560
|
+
if (type === "fusion") {
|
|
561
|
+
const n = count ?? models?.length ?? 3;
|
|
562
|
+
taskPrompts = Array(n).fill(prompts[0]);
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
if (type === "meta" && prompts.length === 1) {
|
|
566
|
+
taskPrompts = [prompts[0]]; // Meta delegates to subagent chain internally
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
// Auto-select backend
|
|
570
|
+
const backend = backendOverride ?? (type === "fusion" || type === "zero" || type === "long" ? "native" : "subagent");
|
|
571
|
+
|
|
572
|
+
const label = type === "fusion"
|
|
573
|
+
? `Fusion: ${prompts[0]?.slice(0, 40)}`
|
|
574
|
+
: `${type}: ${taskPrompts.length} tasks`;
|
|
575
|
+
|
|
576
|
+
const thread = registry.create(type as ThreadType, label, taskPrompts, {
|
|
577
|
+
models,
|
|
578
|
+
cwd: ctx.cwd,
|
|
579
|
+
backend,
|
|
580
|
+
agent,
|
|
581
|
+
verify,
|
|
582
|
+
});
|
|
583
|
+
|
|
584
|
+
// Dispatch (async — runs in background)
|
|
585
|
+
executor.dispatch(thread);
|
|
586
|
+
|
|
587
|
+
const modelInfo = models ? ` Models: ${models.join(", ")}` : "";
|
|
588
|
+
const verifyInfo = verify ? ` Verify: ${verify}` : "";
|
|
589
|
+
const backendInfo = backend === "subagent" ? " (via pi-subagents)" : " (native pi -p)";
|
|
590
|
+
|
|
591
|
+
return {
|
|
592
|
+
content: [{
|
|
593
|
+
type: "text",
|
|
594
|
+
text: `Thread ${thread.id} (${type}) spawned.${backendInfo}${modelInfo}${verifyInfo}\n${taskPrompts.length} task(s). Use /threads or thread_status to monitor.`,
|
|
595
|
+
}],
|
|
596
|
+
details: { threadId: thread.id, type, taskCount: taskPrompts.length, backend },
|
|
597
|
+
};
|
|
598
|
+
},
|
|
599
|
+
renderCall(args, theme) {
|
|
600
|
+
return new Text(
|
|
601
|
+
theme.fg("toolTitle", theme.bold("thread_spawn ")) +
|
|
602
|
+
theme.fg("accent", args.type) +
|
|
603
|
+
theme.fg("muted", ` (${args.prompts?.length ?? "?"} tasks)`),
|
|
604
|
+
0, 0
|
|
605
|
+
);
|
|
606
|
+
},
|
|
607
|
+
});
|
|
608
|
+
|
|
609
|
+
pi.registerTool({
|
|
610
|
+
name: "thread_status",
|
|
611
|
+
label: "Thread Status",
|
|
612
|
+
description: "Get status of all threads and stories, or a specific thread/story by ID",
|
|
613
|
+
parameters: Type.Object({
|
|
614
|
+
id: Type.Optional(Type.String({ description: "Thread ID (t-001) or Story ID (s-001). Omit for all." })),
|
|
615
|
+
}),
|
|
616
|
+
async execute(_toolCallId, params, _signal?: any, _onUpdate?: any, _ctx?: any) {
|
|
617
|
+
if (params.id) {
|
|
618
|
+
// Check threads first
|
|
619
|
+
const t = registry.get(params.id);
|
|
620
|
+
if (t) {
|
|
621
|
+
const sum = registry.summarize(t);
|
|
622
|
+
const taskDetails = t.tasks
|
|
623
|
+
.map((tk) => {
|
|
624
|
+
let line = ` ${stateIcon(tk.state)} ${tk.id} [${tk.state}] ${tk.label}`;
|
|
625
|
+
if (tk.model) line += ` [${tk.model}]`;
|
|
626
|
+
if (tk.result) line += `\n ${tk.result.slice(0, 300)}`;
|
|
627
|
+
if (tk.error) line += `\n ERROR: ${tk.error.slice(0, 200)}`;
|
|
628
|
+
return line;
|
|
629
|
+
})
|
|
630
|
+
.join("\n");
|
|
631
|
+
return {
|
|
632
|
+
content: [{
|
|
633
|
+
type: "text",
|
|
634
|
+
text: `Thread ${sum.id} (${sum.type}) [${sum.backend}] — ${sum.state} — ${sum.progress} — ${sum.elapsed}\n${taskDetails}`,
|
|
635
|
+
}],
|
|
636
|
+
};
|
|
637
|
+
}
|
|
638
|
+
|
|
639
|
+
// Check stories
|
|
640
|
+
const s = registry.getStory(params.id);
|
|
641
|
+
if (s) {
|
|
642
|
+
const phases = s.phases
|
|
643
|
+
.map((p) => ` ${stateIcon(p.state)} ${p.name} (${p.threadType}): ${p.description}${p.threadId ? ` [${p.threadId}]` : ""}`)
|
|
644
|
+
.join("\n");
|
|
645
|
+
return {
|
|
646
|
+
content: [{
|
|
647
|
+
type: "text",
|
|
648
|
+
text: `Story ${s.id} [${s.state}] — ${s.goal}\n${phases}`,
|
|
649
|
+
}],
|
|
650
|
+
};
|
|
651
|
+
}
|
|
652
|
+
|
|
653
|
+
return { content: [{ type: "text", text: `ID ${params.id} not found` }], isError: true } as any;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
// All
|
|
657
|
+
const lines: string[] = [];
|
|
658
|
+
const stories = registry.allStories();
|
|
659
|
+
const threads = registry.all();
|
|
660
|
+
|
|
661
|
+
if (stories.length > 0) {
|
|
662
|
+
lines.push("📖 Stories:");
|
|
663
|
+
for (const s of stories) {
|
|
664
|
+
const phases = s.phases.map((p) => `${stateIcon(p.state)}${p.name}`).join("→");
|
|
665
|
+
lines.push(` ${s.id} [${s.state}] ${s.goal.slice(0, 50)} — ${phases}`);
|
|
666
|
+
}
|
|
667
|
+
}
|
|
668
|
+
|
|
669
|
+
if (threads.length > 0) {
|
|
670
|
+
lines.push("🧵 Threads:");
|
|
671
|
+
for (const t of threads) {
|
|
672
|
+
const s = registry.summarize(t);
|
|
673
|
+
lines.push(` ${s.id} ${typeIcon(s.type)} ${s.type} [${s.state}] ${s.progress} (${s.elapsed}) [${s.backend}] — ${s.label}`);
|
|
674
|
+
}
|
|
675
|
+
}
|
|
676
|
+
|
|
677
|
+
if (lines.length === 0) {
|
|
678
|
+
return { content: [{ type: "text", text: "No threads or stories." }] } as any;
|
|
679
|
+
}
|
|
680
|
+
|
|
681
|
+
return { content: [{ type: "text", text: lines.join("\n") }] } as any;
|
|
682
|
+
},
|
|
683
|
+
});
|
|
684
|
+
|
|
685
|
+
pi.registerTool({
|
|
686
|
+
name: "thread_kill",
|
|
687
|
+
label: "Thread Kill",
|
|
688
|
+
description: "Kill a running thread by ID",
|
|
689
|
+
parameters: Type.Object({
|
|
690
|
+
id: Type.String({ description: "Thread ID to kill" }),
|
|
691
|
+
}),
|
|
692
|
+
async execute(_toolCallId, params, _signal?: any, _onUpdate?: any, _ctx?: any) {
|
|
693
|
+
const t = registry.get(params.id);
|
|
694
|
+
if (!t) return { content: [{ type: "text", text: `Thread ${params.id} not found` }], isError: true };
|
|
695
|
+
registry.kill(params.id);
|
|
696
|
+
return { content: [{ type: "text", text: `Thread ${params.id} killed.` }] } as any;
|
|
697
|
+
},
|
|
698
|
+
});
|
|
699
|
+
}
|