@narumitw/pi-herdr 0.2.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -2
- package/dist/chunks/herdr-menu-IUPFF5YK.ts +56 -0
- package/dist/chunks/herdr-menu-IUPFF5YK.ts.map +7 -0
- package/dist/index.ts +1587 -0
- package/dist/index.ts.map +7 -0
- package/package.json +55 -52
- package/skills/herdr/SKILL.md +12 -0
- package/src/herdr-agent-state.ts +404 -411
- package/src/herdr-client.ts +236 -238
- package/src/herdr-menu.ts +49 -50
- package/src/herdr-metadata.ts +46 -52
- package/src/herdr-observer.ts +334 -372
- package/src/herdr-protocol.ts +185 -187
- package/src/herdr-settings-controller.ts +118 -124
- package/src/herdr-widget.ts +204 -217
- package/src/settings.ts +131 -135
|
@@ -1,135 +1,129 @@
|
|
|
1
1
|
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
2
2
|
import type { HerdrWidgetObserver } from "./herdr-observer.js";
|
|
3
|
-
import {
|
|
4
|
-
awaitHerdrSettingsWrites,
|
|
5
|
-
herdrSettingsPath,
|
|
6
|
-
readHerdrSettings,
|
|
7
|
-
updateHerdrSettings,
|
|
8
|
-
} from "./settings.js";
|
|
3
|
+
import { awaitHerdrSettingsWrites, herdrSettingsPath, readHerdrSettings, updateHerdrSettings } from "./settings.js";
|
|
9
4
|
|
|
10
5
|
export interface HerdrSettingsOptions {
|
|
11
|
-
|
|
6
|
+
settingsPath?: string;
|
|
12
7
|
}
|
|
13
8
|
|
|
14
9
|
export function createHerdrSettingsController(
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
10
|
+
pi: ExtensionAPI,
|
|
11
|
+
observer: HerdrWidgetObserver,
|
|
12
|
+
options: HerdrSettingsOptions = {},
|
|
18
13
|
) {
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
14
|
+
const settingsPath = options.settingsPath ?? herdrSettingsPath();
|
|
15
|
+
let generation = 0;
|
|
16
|
+
let owner: ExtensionContext | undefined;
|
|
17
|
+
let controller = new AbortController();
|
|
18
|
+
let enabled = true;
|
|
19
|
+
let changes = Promise.resolve();
|
|
20
|
+
let menuOpen = false;
|
|
21
|
+
const current = (expected: number) => expected === generation && !controller.signal.aborted;
|
|
27
22
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
});
|
|
23
|
+
pi.registerCommand("herdr", {
|
|
24
|
+
description: "Configure the Herdr agent widget",
|
|
25
|
+
handler: async (args, ctx) => {
|
|
26
|
+
if (args.trim()) throw new Error("/herdr does not accept arguments.");
|
|
27
|
+
if (!ctx.hasUI || (ctx.mode !== "tui" && ctx.mode !== "rpc")) {
|
|
28
|
+
throw new Error("/herdr requires TUI or RPC mode.");
|
|
29
|
+
}
|
|
30
|
+
if (!owner || ctx.sessionManager !== owner.sessionManager || menuOpen) return;
|
|
31
|
+
const expected = generation;
|
|
32
|
+
const signal = controller.signal;
|
|
33
|
+
menuOpen = true;
|
|
34
|
+
try {
|
|
35
|
+
const [{ runMenu }, { createHerdrMenu }] = await Promise.all([
|
|
36
|
+
import("@narumitw/pi-tui-kit"),
|
|
37
|
+
import("./herdr-menu.js"),
|
|
38
|
+
]);
|
|
39
|
+
if (!current(expected)) return;
|
|
40
|
+
await runMenu(
|
|
41
|
+
ctx,
|
|
42
|
+
createHerdrMenu({
|
|
43
|
+
settingsPath,
|
|
44
|
+
isEnabled: () => enabled,
|
|
45
|
+
toggle: (actionSignal) => {
|
|
46
|
+
const result = changes.then(async () => {
|
|
47
|
+
if (actionSignal.aborted || !current(expected) || !owner) return false;
|
|
48
|
+
// Once accepted, finish the explicit save even if the menu closes.
|
|
49
|
+
// Session replacement still prevents stale runtime publication.
|
|
50
|
+
const previous = enabled;
|
|
51
|
+
const actionOwner = owner;
|
|
52
|
+
try {
|
|
53
|
+
enabled = !previous;
|
|
54
|
+
if (enabled && actionOwner.mode === "tui") observer.start(actionOwner);
|
|
55
|
+
else await observer.shutdown(actionOwner);
|
|
56
|
+
if (!current(expected)) return false;
|
|
57
|
+
await updateHerdrSettings({ widget: enabled }, { settingsPath });
|
|
58
|
+
return current(expected);
|
|
59
|
+
} catch {
|
|
60
|
+
if (!current(expected)) return false;
|
|
61
|
+
enabled = previous;
|
|
62
|
+
try {
|
|
63
|
+
if (previous && actionOwner.mode === "tui") observer.start(actionOwner);
|
|
64
|
+
else await observer.shutdown(actionOwner);
|
|
65
|
+
} finally {
|
|
66
|
+
if (current(expected))
|
|
67
|
+
ctx.ui.notify(
|
|
68
|
+
"Herdr settings were not saved; the previous widget setting was restored. Check pi-herdr.json and its permissions.",
|
|
69
|
+
"warning",
|
|
70
|
+
);
|
|
71
|
+
}
|
|
72
|
+
return false;
|
|
73
|
+
}
|
|
74
|
+
});
|
|
75
|
+
changes = result.then(
|
|
76
|
+
() => undefined,
|
|
77
|
+
() => undefined,
|
|
78
|
+
);
|
|
79
|
+
return result;
|
|
80
|
+
},
|
|
81
|
+
}),
|
|
82
|
+
{
|
|
83
|
+
getState: () => undefined,
|
|
84
|
+
signal,
|
|
85
|
+
isCurrent: () => current(expected),
|
|
86
|
+
onError: () => {
|
|
87
|
+
if (current(expected)) ctx.ui.notify("The Herdr menu could not be displayed.", "error");
|
|
88
|
+
},
|
|
89
|
+
},
|
|
90
|
+
);
|
|
91
|
+
} finally {
|
|
92
|
+
if (expected === generation) menuOpen = false;
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
});
|
|
102
96
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
97
|
+
return {
|
|
98
|
+
async start(ctx: ExtensionContext) {
|
|
99
|
+
const expected = ++generation;
|
|
100
|
+
controller.abort();
|
|
101
|
+
controller = new AbortController();
|
|
102
|
+
menuOpen = false;
|
|
103
|
+
const previous = owner;
|
|
104
|
+
owner = ctx;
|
|
105
|
+
if (previous) await observer.shutdown(previous);
|
|
106
|
+
if (!current(expected)) return;
|
|
107
|
+
await changes;
|
|
108
|
+
if (!current(expected)) return;
|
|
109
|
+
const loaded = await readHerdrSettings(settingsPath);
|
|
110
|
+
if (!current(expected)) return;
|
|
111
|
+
enabled = loaded.settings.widget;
|
|
112
|
+
if (loaded.kind === "invalid" && ctx.hasUI)
|
|
113
|
+
ctx.ui.notify(
|
|
114
|
+
"Herdr ignored invalid pi-herdr.json settings and kept the widget enabled. Fix the file before saving.",
|
|
115
|
+
"warning",
|
|
116
|
+
);
|
|
117
|
+
if (enabled && ctx.mode === "tui") observer.start(ctx);
|
|
118
|
+
},
|
|
119
|
+
async shutdown(ctx: ExtensionContext) {
|
|
120
|
+
if (ctx.sessionManager !== owner?.sessionManager) return;
|
|
121
|
+
generation += 1;
|
|
122
|
+
controller.abort();
|
|
123
|
+
owner = undefined;
|
|
124
|
+
menuOpen = false;
|
|
125
|
+
await Promise.all([observer.shutdown(ctx), changes]);
|
|
126
|
+
await awaitHerdrSettingsWrites(settingsPath);
|
|
127
|
+
},
|
|
128
|
+
};
|
|
135
129
|
}
|