jules-orchestrator-kit 0.5.2 → 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/.agent/jules.yml +1 -1
- package/.github/ISSUE_TEMPLATE/bug_report.md +63 -0
- package/.github/ISSUE_TEMPLATE/feature_request.md +34 -0
- package/.github/social-preview.png +0 -0
- package/.github/workflows/agent-scope-guard.yml +3 -2
- package/.github/workflows/jules-audit.yml +2 -2
- package/README.md +99 -204
- package/index.mjs +2 -2
- package/package.json +1 -1
- package/scripts/command-resolver.mjs +2 -2
- package/scripts/jules-create.mjs +22 -2
- package/scripts/jules-dispatch.mjs +36 -39
- package/scripts/jules-queue-runner.mjs +48 -3
- package/scripts/jules-scan-todos.mjs +7 -7
- package/scripts/jules-self-audit.mjs +127 -18
- package/scripts/jules-swarm.mjs +4 -1
- package/scripts/lock-manager.mjs +51 -17
- package/scripts/utils.mjs +139 -0
package/scripts/utils.mjs
CHANGED
|
@@ -92,3 +92,142 @@ export function resolveMarkdownConflict(content) {
|
|
|
92
92
|
|
|
93
93
|
return result.join("\n");
|
|
94
94
|
}
|
|
95
|
+
|
|
96
|
+
export function calculateShannonEntropy(str) {
|
|
97
|
+
const len = str.length;
|
|
98
|
+
if (len === 0) return 0;
|
|
99
|
+
const frequencies = {};
|
|
100
|
+
for (let i = 0; i < len; i++) {
|
|
101
|
+
frequencies[str[i]] = (frequencies[str[i]] || 0) + 1;
|
|
102
|
+
}
|
|
103
|
+
return Object.values(frequencies).reduce((sum, count) => {
|
|
104
|
+
const p = count / len;
|
|
105
|
+
return sum - p * Math.log2(p);
|
|
106
|
+
}, 0);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export function redactSecrets(text) {
|
|
110
|
+
if (!text) return "";
|
|
111
|
+
let sanitized = text;
|
|
112
|
+
|
|
113
|
+
for (const [envKey, envVal] of Object.entries(process.env)) {
|
|
114
|
+
if (
|
|
115
|
+
envVal &&
|
|
116
|
+
(envVal.length >= 20 || calculateShannonEntropy(envVal) > 3.6) &&
|
|
117
|
+
/KEY|SECRET|TOKEN|PASSWORD|CREDENTIAL|AUTH/i.test(envKey)
|
|
118
|
+
) {
|
|
119
|
+
if (sanitized.includes(envVal)) {
|
|
120
|
+
sanitized = sanitized.split(envVal).join("[REDACTED_ENV_SECRET]");
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
const patterns = [
|
|
126
|
+
/\bgh[pousr]_[a-zA-Z0-9]{36,}\b/g,
|
|
127
|
+
/\bgithub_pat_[a-zA-Z0-9]{22}_[a-zA-Z0-9]{59}\b/g,
|
|
128
|
+
/\bAKIA[0-9A-Z]{16}\b/g,
|
|
129
|
+
/\bAIza[0-9A-Za-z_-]{30,40}\b/g,
|
|
130
|
+
/\bya29\.[a-zA-Z0-9_\-]{20,}\b/g,
|
|
131
|
+
/\bBearer\s+[a-zA-Z0-9\-\._~+\/]+=*/g,
|
|
132
|
+
/\bsk-(?:ant-api03-|proj-|svcacct-)[a-zA-Z0-9\-\_]{32,}\b/g,
|
|
133
|
+
/\bxox[baprs]-[a-zA-Z0-9\-]{10,}\b/g,
|
|
134
|
+
/\beyJ[a-zA-Z0-9_\-]{10,}\.[a-zA-Z0-9_\-]{10,}\.[a-zA-Z0-9_\-]{10,}\b/g,
|
|
135
|
+
/-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
|
|
136
|
+
/\bnpm_[a-zA-Z0-9]{36}\b/g,
|
|
137
|
+
/\b(?:sk|rk|pk)_(?:live|test)_[0-9a-zA-Z]{24,}\b/g,
|
|
138
|
+
];
|
|
139
|
+
for (const pat of patterns) {
|
|
140
|
+
sanitized = sanitized.replace(pat, "[REDACTED_BY_SECURITY_GATE]");
|
|
141
|
+
}
|
|
142
|
+
return sanitized;
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export function appendLedger(ledgerName, payload) {
|
|
146
|
+
const stateDir = path.resolve(process.env.JULES_PROJECT_ROOT || process.cwd(), ".agent/state");
|
|
147
|
+
ensureDir(stateDir);
|
|
148
|
+
const ledgerPath = path.join(stateDir, `${ledgerName}.jsonl`);
|
|
149
|
+
const entry = JSON.stringify({
|
|
150
|
+
timestamp: new Date().toISOString(),
|
|
151
|
+
...payload
|
|
152
|
+
}) + "\n";
|
|
153
|
+
fs.appendFileSync(ledgerPath, entry, "utf-8");
|
|
154
|
+
return ledgerPath;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
export function checkDailyBudget(maxSessions = 300) {
|
|
158
|
+
const dateStr = new Date().toISOString().split("T")[0];
|
|
159
|
+
const stateDir = path.resolve(process.env.JULES_PROJECT_ROOT || process.cwd(), ".agent/state");
|
|
160
|
+
const sessionsLedger = path.join(stateDir, "sessions.jsonl");
|
|
161
|
+
|
|
162
|
+
if (!fs.existsSync(sessionsLedger)) {
|
|
163
|
+
return { ok: true, used: 0, budget: maxSessions };
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
const content = fs.readFileSync(sessionsLedger, "utf-8");
|
|
167
|
+
const lines = content.split("\n").filter(Boolean);
|
|
168
|
+
|
|
169
|
+
let usedToday = 0;
|
|
170
|
+
for (const line of lines) {
|
|
171
|
+
try {
|
|
172
|
+
const entry = JSON.parse(line);
|
|
173
|
+
if (
|
|
174
|
+
entry.timestamp &&
|
|
175
|
+
entry.timestamp.startsWith(dateStr) &&
|
|
176
|
+
(entry.event === "session_dispatched" || entry.event === "budget_reserved" || !entry.event)
|
|
177
|
+
) {
|
|
178
|
+
usedToday++;
|
|
179
|
+
}
|
|
180
|
+
} catch (e) {
|
|
181
|
+
// Ignore
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
return { ok: usedToday < maxSessions, used: usedToday, budget: maxSessions };
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
export function reserveDailyBudget(maxSessions = 300, taskKey = "") {
|
|
189
|
+
const stateDir = path.resolve(process.env.JULES_PROJECT_ROOT || process.cwd(), ".agent/state");
|
|
190
|
+
ensureDir(stateDir);
|
|
191
|
+
|
|
192
|
+
const lockFile = path.join(stateDir, "budget.lock");
|
|
193
|
+
let fd;
|
|
194
|
+
|
|
195
|
+
try {
|
|
196
|
+
fd = fs.openSync(lockFile, "wx");
|
|
197
|
+
} catch {
|
|
198
|
+
// If lock fails, wait 50ms and retry once before returning locked state
|
|
199
|
+
try {
|
|
200
|
+
fd = fs.openSync(lockFile, "w");
|
|
201
|
+
} catch {
|
|
202
|
+
return { ok: false, reason: "locked", used: null, budget: maxSessions };
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
try {
|
|
207
|
+
const check = checkDailyBudget(maxSessions);
|
|
208
|
+
if (!check.ok) {
|
|
209
|
+
return check;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
appendLedger("sessions", {
|
|
213
|
+
event: "budget_reserved",
|
|
214
|
+
task_key: taskKey,
|
|
215
|
+
status: "reserved"
|
|
216
|
+
});
|
|
217
|
+
|
|
218
|
+
return {
|
|
219
|
+
ok: true,
|
|
220
|
+
used: check.used + 1,
|
|
221
|
+
budget: maxSessions
|
|
222
|
+
};
|
|
223
|
+
} finally {
|
|
224
|
+
if (fd !== undefined) {
|
|
225
|
+
try {
|
|
226
|
+
fs.closeSync(fd);
|
|
227
|
+
} catch {}
|
|
228
|
+
try {
|
|
229
|
+
fs.rmSync(lockFile, { force: true });
|
|
230
|
+
} catch {}
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
}
|