wayform 0.4.4 → 0.6.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.
- package/README.md +15 -17
- package/dist/admin.js +42 -0
- package/dist/admin.js.map +1 -0
- package/dist/build-skill.js +116 -28
- package/dist/build-skill.js.map +1 -1
- package/dist/check-skill.js +73 -0
- package/dist/check-skill.js.map +1 -0
- package/dist/cli.js +8 -3
- package/dist/cli.js.map +1 -1
- package/dist/guard-hook.js +1 -0
- package/dist/guard-hook.js.map +1 -1
- package/dist/hook-clients.js +3 -1
- package/dist/hook-clients.js.map +1 -1
- package/dist/hook.js +20 -11
- package/dist/hook.js.map +1 -1
- package/dist/init-configs.js +97 -0
- package/dist/init-configs.js.map +1 -1
- package/dist/init-remote.js +29 -6
- package/dist/init-remote.js.map +1 -1
- package/dist/pointers.js +12 -0
- package/dist/pointers.js.map +1 -0
- package/dist/prompt-hook.js +12 -1
- package/dist/prompt-hook.js.map +1 -1
- package/dist/remote-read.js +16 -2
- package/dist/remote-read.js.map +1 -1
- package/dist/session-prompt.js +17 -61
- package/dist/session-prompt.js.map +1 -1
- package/dist/shown-ids.js +110 -0
- package/dist/shown-ids.js.map +1 -0
- package/dist/token-budget.js +6 -0
- package/dist/token-budget.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-session set of fact ids already shown to the agent (briefing + prompt
|
|
3
|
+
* pointers), so /hook/prompt can `exclude` them instead of re-sending.
|
|
4
|
+
*
|
|
5
|
+
* Best-effort by design: a bad session id disables the set, a missing or
|
|
6
|
+
* corrupt file reads as empty, and every error logs one stderr line (stdout is
|
|
7
|
+
* the hook's injection channel) and is swallowed.
|
|
8
|
+
*/
|
|
9
|
+
import { randomBytes } from "node:crypto";
|
|
10
|
+
import { lstatSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
|
|
11
|
+
import { tmpdir } from "node:os";
|
|
12
|
+
import { dirname, join } from "node:path";
|
|
13
|
+
const SESSION_ID_RE = /^[A-Za-z0-9_-]{1,128}$/;
|
|
14
|
+
const MAX_SHOWN = 500;
|
|
15
|
+
/** The set's file, or null when `sessionId` isn't a safe filename. */
|
|
16
|
+
export function shownPath(sessionId) {
|
|
17
|
+
if (typeof sessionId !== "string" || !SESSION_ID_RE.test(sessionId))
|
|
18
|
+
return null;
|
|
19
|
+
// tmpdir() at call time, so TMPDIR set after import is honoured. Per-uid
|
|
20
|
+
// folder so one user creating it on a shared /tmp can't lock out the rest.
|
|
21
|
+
const uid = process.getuid?.();
|
|
22
|
+
const dir = uid === undefined ? "wayform-shown" : `wayform-shown-${uid}`;
|
|
23
|
+
return join(tmpdir(), dir, `${sessionId}.json`);
|
|
24
|
+
}
|
|
25
|
+
function warn(what, err) {
|
|
26
|
+
process.stderr.write(`wayform: shown-ids ${what} failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* The set's file if its folder is safe to use, else null. tmpdir() may be a
|
|
30
|
+
* shared /tmp, so the folder must be a real directory, ours, and closed to
|
|
31
|
+
* group/other — otherwise another user could read or plant the set. Windows
|
|
32
|
+
* has no POSIX mode bits (Node reports 0o666/0o777) and its tmpdir() is
|
|
33
|
+
* already per-user, so only the real-directory check applies there.
|
|
34
|
+
*/
|
|
35
|
+
function safePath(sessionId) {
|
|
36
|
+
const p = shownPath(sessionId);
|
|
37
|
+
if (!p)
|
|
38
|
+
return null;
|
|
39
|
+
const dir = dirname(p);
|
|
40
|
+
try {
|
|
41
|
+
mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
42
|
+
const st = lstatSync(dir);
|
|
43
|
+
const uid = process.getuid?.();
|
|
44
|
+
const posix = process.platform !== "win32";
|
|
45
|
+
if (!st.isDirectory() ||
|
|
46
|
+
(posix && uid !== undefined && st.uid !== uid) ||
|
|
47
|
+
(posix && (st.mode & 0o077) !== 0))
|
|
48
|
+
throw new Error(`${dir} is not a private directory`);
|
|
49
|
+
}
|
|
50
|
+
catch (err) {
|
|
51
|
+
warn("dir check", err);
|
|
52
|
+
return null;
|
|
53
|
+
}
|
|
54
|
+
return p;
|
|
55
|
+
}
|
|
56
|
+
export function readShown(sessionId) {
|
|
57
|
+
const p = safePath(sessionId);
|
|
58
|
+
if (!p)
|
|
59
|
+
return [];
|
|
60
|
+
let raw;
|
|
61
|
+
try {
|
|
62
|
+
if (lstatSync(p).isSymbolicLink()) {
|
|
63
|
+
warn("read", new Error(`${p} is a symlink`));
|
|
64
|
+
return [];
|
|
65
|
+
}
|
|
66
|
+
raw = readFileSync(p, "utf8");
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
return []; // missing file = nothing shown yet, not an error
|
|
70
|
+
}
|
|
71
|
+
try {
|
|
72
|
+
const ids = JSON.parse(raw);
|
|
73
|
+
return Array.isArray(ids)
|
|
74
|
+
? ids.filter((x) => typeof x === "string")
|
|
75
|
+
: [];
|
|
76
|
+
}
|
|
77
|
+
catch (err) {
|
|
78
|
+
warn("read", err);
|
|
79
|
+
return [];
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
function write(sessionId, ids) {
|
|
83
|
+
const p = safePath(sessionId);
|
|
84
|
+
if (!p)
|
|
85
|
+
return;
|
|
86
|
+
try {
|
|
87
|
+
// Temp file + rename: a reader never sees a half-written file. Random
|
|
88
|
+
// name + wx so a planted file or symlink can't be written through.
|
|
89
|
+
const tmp = `${p}.${randomBytes(6).toString("hex")}.tmp`;
|
|
90
|
+
writeFileSync(tmp, JSON.stringify(ids.slice(-MAX_SHOWN)), {
|
|
91
|
+
flag: "wx",
|
|
92
|
+
mode: 0o600,
|
|
93
|
+
});
|
|
94
|
+
renameSync(tmp, p);
|
|
95
|
+
}
|
|
96
|
+
catch (err) {
|
|
97
|
+
warn("write", err);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
/** Union `ids` into the set, keeping the last 500. */
|
|
101
|
+
export function addShown(sessionId, ids) {
|
|
102
|
+
if (!safePath(sessionId))
|
|
103
|
+
return;
|
|
104
|
+
write(sessionId, [...new Set([...readShown(sessionId), ...ids])]);
|
|
105
|
+
}
|
|
106
|
+
/** Overwrite the set (session start, incl. compact). */
|
|
107
|
+
export function resetShown(sessionId, ids) {
|
|
108
|
+
write(sessionId, ids);
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=shown-ids.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shown-ids.js","sourceRoot":"","sources":["../src/shown-ids.ts"],"names":[],"mappings":"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"}
|
package/dist/token-budget.js
CHANGED
|
@@ -17,6 +17,12 @@ export const DEFAULT_BUDGET_TOKENS = 4000;
|
|
|
17
17
|
* spec default (decision 63917dee).
|
|
18
18
|
*/
|
|
19
19
|
export const PROMPT_BUDGET_TOKENS = 1500;
|
|
20
|
+
/**
|
|
21
|
+
* Data part of the session-start briefing (plan #52): the compact policy takes
|
|
22
|
+
* the rest of a 2,000-token session-start text. Pointers, not full facts, so
|
|
23
|
+
* the agent fetches depth with read_context(ids) instead of paying for it here.
|
|
24
|
+
*/
|
|
25
|
+
export const BRIEFING_BUDGET_TOKENS = 1700;
|
|
20
26
|
/** Approx fixed overhead per rendered entry block (header line + separator). */
|
|
21
27
|
export const ENTRY_OVERHEAD_TOKENS = 12;
|
|
22
28
|
/**
|
package/dist/token-budget.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../src/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAIxC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,YAAoB;IAEpB,IAAI,YAAY,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE9D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,qBAAqB,CAAC;QACxE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,YAAY;YAAE,MAAM;QAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC"}
|
|
1
|
+
{"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../src/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAIxC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,YAAoB;IAEpB,IAAI,YAAY,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE9D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,qBAAqB,CAAC;QACxE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,YAAY;YAAE,MAAM;QAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC"}
|
package/package.json
CHANGED