@oked/sdk 0.6.5 → 0.6.6
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/dist/classify.d.ts +12 -0
- package/dist/classify.js +52 -3
- package/dist/describe.js +305 -24
- package/dist/kinds.d.ts +2 -2
- package/dist/kinds.js +1 -1
- package/package.json +2 -2
package/dist/classify.d.ts
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
import type { RiskTier } from "./types.js";
|
|
2
2
|
export declare function classify(toolName: string, toolInput: Record<string, unknown>): RiskTier;
|
|
3
|
+
/** Split a shell command into top-level segments on the operators that
|
|
4
|
+
* sequence separate commands: `|`, `||`, `&&`, `;`, and a bare newline (a
|
|
5
|
+
* newline separates commands in a multi-line script exactly like `;`).
|
|
6
|
+
* Operators inside quoted strings, command substitutions, and heredoc bodies —
|
|
7
|
+
* including the `"$(cat <<'EOF' … )"` heredoc form used for commit messages —
|
|
8
|
+
* are kept intact so message text isn't split. A backslash-escaped newline is a
|
|
9
|
+
* line continuation, not a separator. Returns trimmed, non-empty segments.
|
|
10
|
+
* With `pipes: false`, a pipeline (`a | b`) stays one segment: the card text
|
|
11
|
+
* reads a pipeline as one step (`printf … | himalaya message send`). */
|
|
12
|
+
export declare function splitTopLevel(cmd: string, opts?: {
|
|
13
|
+
pipes?: boolean;
|
|
14
|
+
}): string[];
|
|
3
15
|
export type ShellWriteKind = "create" | "append" | "edit" | "touch" | "copy" | "move";
|
|
4
16
|
export interface ShellWriteOp {
|
|
5
17
|
kind: ShellWriteKind;
|
package/dist/classify.js
CHANGED
|
@@ -218,6 +218,13 @@ const HIGH_STAKES_STAGE = [
|
|
|
218
218
|
/^killall\b/,
|
|
219
219
|
// Wide-open permissions.
|
|
220
220
|
/^chmod\s+(?:-\S+\s+)*777\b/,
|
|
221
|
+
// GitHub CLI: merging a PR changes the base branch for everyone (and often
|
|
222
|
+
// deploys); deletes and archives can't be undone from here.
|
|
223
|
+
/^gh\s+pr\s+merge\b/,
|
|
224
|
+
/^gh\s+(?:repo|release|issue|label|gist|secret|variable|cache|run|ruleset)\s+delete\b/,
|
|
225
|
+
/^gh\s+repo\s+archive\b/,
|
|
226
|
+
// Railway deploys and tear-downs change a live service.
|
|
227
|
+
/^railway\s+(?:up|deploy|redeploy|down|delete)\b/,
|
|
221
228
|
];
|
|
222
229
|
// curl request-method / request-body flags, scanned PER-STAGE (a single stage
|
|
223
230
|
// has no top-level pipe, so `\bcurl\b.*` can't cross into another command — the
|
|
@@ -241,7 +248,34 @@ const HIGH_STAKES_CURL_STAGE = [
|
|
|
241
248
|
// message delete, folder purge — are high_stakes in the full scan above.)
|
|
242
249
|
const REVIEW_COMMANDS = [
|
|
243
250
|
/^himalaya\s+message\s+(send|reply|forward)\b/,
|
|
251
|
+
// GitHub CLI writes other people see (comments, reviews, issues, releases)
|
|
252
|
+
// or that change the repo's settings and CI. They can be edited or undone.
|
|
253
|
+
/^gh\s+pr\s+(?:close|reopen|comment|review|edit|ready|lock|unlock)\b/,
|
|
254
|
+
/^gh\s+issue\s+(?:create|close|reopen|comment|edit|transfer|lock|unlock|pin|unpin)\b/,
|
|
255
|
+
/^gh\s+release\s+(?:create|edit|upload)\b/,
|
|
256
|
+
/^gh\s+repo\s+(?:create|edit|rename|fork)\b/,
|
|
257
|
+
/^gh\s+(?:secret|variable)\s+set\b/,
|
|
258
|
+
/^gh\s+workflow\s+(?:run|enable|disable)\b/,
|
|
259
|
+
/^gh\s+run\s+(?:cancel|rerun)\b/,
|
|
260
|
+
/^gh\s+(?:gist|label)\s+(?:create|edit)\b/,
|
|
244
261
|
];
|
|
262
|
+
/**
|
|
263
|
+
* `gh api` is curl for GitHub: a mutating method, or fields without a method
|
|
264
|
+
* (gh then sends a POST), is an outward write like a curl POST. A GraphQL call
|
|
265
|
+
* is a write only when it holds a mutation. Returns null for other commands.
|
|
266
|
+
*/
|
|
267
|
+
function classifyGhApiStage(stage) {
|
|
268
|
+
if (!/^gh\s+api\b/.test(stage))
|
|
269
|
+
return null;
|
|
270
|
+
const method = stage.match(/\s(?:-X|--method)(?:\s+|=)?([A-Za-z]+)\b/)?.[1]?.toUpperCase();
|
|
271
|
+
if (method && method !== "GET" && method !== "HEAD")
|
|
272
|
+
return "high_stakes";
|
|
273
|
+
if (/^gh\s+api\s+graphql\b/.test(stage))
|
|
274
|
+
return /\bmutation\b/.test(stage) ? "high_stakes" : "safe";
|
|
275
|
+
if (!method && /\s(?:-f|-F|--field|--raw-field|--input)(?:\s|=)/.test(stage))
|
|
276
|
+
return "high_stakes";
|
|
277
|
+
return "safe";
|
|
278
|
+
}
|
|
245
279
|
// Local-mutation MARKERS for DETECTED side effects. These never gate a prompt —
|
|
246
280
|
// under the effect-based model anything not flagged destructive/outward/sensitive
|
|
247
281
|
// already auto-allows. They exist only to pick the `warning` (logged) vs `safe`
|
|
@@ -437,8 +471,11 @@ function maxTier(a, b) {
|
|
|
437
471
|
* Operators inside quoted strings, command substitutions, and heredoc bodies —
|
|
438
472
|
* including the `"$(cat <<'EOF' … )"` heredoc form used for commit messages —
|
|
439
473
|
* are kept intact so message text isn't split. A backslash-escaped newline is a
|
|
440
|
-
* line continuation, not a separator. Returns trimmed, non-empty segments.
|
|
441
|
-
|
|
474
|
+
* line continuation, not a separator. Returns trimmed, non-empty segments.
|
|
475
|
+
* With `pipes: false`, a pipeline (`a | b`) stays one segment: the card text
|
|
476
|
+
* reads a pipeline as one step (`printf … | himalaya message send`). */
|
|
477
|
+
export function splitTopLevel(cmd, opts = {}) {
|
|
478
|
+
const splitPipes = opts.pipes !== false;
|
|
442
479
|
const out = [];
|
|
443
480
|
let cur = "";
|
|
444
481
|
let quote = null;
|
|
@@ -510,7 +547,7 @@ function splitTopLevel(cmd) {
|
|
|
510
547
|
i += 2; // consume both operator chars
|
|
511
548
|
continue;
|
|
512
549
|
}
|
|
513
|
-
if (ch === "
|
|
550
|
+
if (ch === ";" || (ch === "|" && splitPipes)) {
|
|
514
551
|
out.push(cur.trim());
|
|
515
552
|
cur = "";
|
|
516
553
|
i++;
|
|
@@ -890,6 +927,9 @@ function classifyStageShellEffects(stage, ephemeralVars = new Set()) {
|
|
|
890
927
|
return isLoopbackHttpStage(stage) ? "warning" : "high_stakes";
|
|
891
928
|
}
|
|
892
929
|
}
|
|
930
|
+
const ghApiTier = classifyGhApiStage(bareStage);
|
|
931
|
+
if (ghApiTier !== null)
|
|
932
|
+
return ghApiTier;
|
|
893
933
|
// Variable assignments: `NAME=value` (pure) or `NAME=$(cmd) rest` (env prefix
|
|
894
934
|
// / capture). Classify the command-substitution inners and any trailing
|
|
895
935
|
// command; a purely literal assignment is safe. Dangerous substitutions were
|
|
@@ -1389,6 +1429,8 @@ const CCD_SAFE_TOOLS = new Map([
|
|
|
1389
1429
|
["ccd_pr", new Set(["bind_pr", "unbind_pr"])],
|
|
1390
1430
|
["ccd_view", new Set(["show_pane", "close_pane", "set_transcript_view"])],
|
|
1391
1431
|
["ccd_session", new Set(["spawn_task"])],
|
|
1432
|
+
// The task list under Claude's message and the end-of-turn summary box.
|
|
1433
|
+
["ccd_turn", new Set(["update_plan", "wrap_up"])],
|
|
1392
1434
|
["ccd_window", new Set(["open_session_in", "close_split", "set_sidebar_collapsed"])],
|
|
1393
1435
|
["ccd_sidebar", new Set([
|
|
1394
1436
|
"create_group", "create_section", "rename_group", "rename_section",
|
|
@@ -1438,6 +1480,13 @@ function classifyMcpTool(toolName, toolInput = {}) {
|
|
|
1438
1480
|
// but each push is gated on its own. Log it, no prompt.
|
|
1439
1481
|
if (parts.includes("ccd_pr") && tool === "set_monitor")
|
|
1440
1482
|
return "warning";
|
|
1483
|
+
// Start a new local Claude session, or move this task into one. Its own tool
|
|
1484
|
+
// calls are gated by OKed like this one's, so log it, no prompt. A cloud or
|
|
1485
|
+
// SSH session runs outside this machine's hook, so it stays `review`.
|
|
1486
|
+
if (parts.includes("ccd_session") && (tool === "start_session" || tool === "hand_off_to_session")) {
|
|
1487
|
+
const target = toolInput.target;
|
|
1488
|
+
return target === undefined || target === "local" ? "warning" : "review";
|
|
1489
|
+
}
|
|
1441
1490
|
if (parts.length === 3 && isClaudeDocsWrite(parts[1] || "", tool, toolInput))
|
|
1442
1491
|
return "warning";
|
|
1443
1492
|
const browserServer = parts.slice(1, -1).find((p) => BROWSER_MCP_SERVERS.has(p));
|
package/dist/describe.js
CHANGED
|
@@ -9,7 +9,8 @@
|
|
|
9
9
|
*/
|
|
10
10
|
import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
11
11
|
import { basename, isAbsolute, join, resolve } from "node:path";
|
|
12
|
-
import { extractShellWriteOps } from "./classify.js";
|
|
12
|
+
import { classify, extractShellWriteOps, splitTopLevel } from "./classify.js";
|
|
13
|
+
import { TIER_ORDER } from "./degraded.js";
|
|
13
14
|
const BODY_PREVIEW_MAX = 200;
|
|
14
15
|
const COMMAND_INLINE_MAX = 50;
|
|
15
16
|
const DIFF_HUNK_MAX_LINES = 10;
|
|
@@ -94,15 +95,19 @@ function summarize(toolName, toolInput, ctx) {
|
|
|
94
95
|
* command isn't a mutating HTTP request. Headlines the outward request ahead of
|
|
95
96
|
* an incidental file redirect in a compound command.
|
|
96
97
|
*/
|
|
97
|
-
function summarizeMutatingCurl(
|
|
98
|
-
if (!/\b(?:curl|wget)\b/.test(
|
|
98
|
+
function summarizeMutatingCurl(command) {
|
|
99
|
+
if (!/\b(?:curl|wget)\b/.test(command))
|
|
99
100
|
return null;
|
|
101
|
+
// Read flags from the curl/wget step only: a `--json` or `-d` on another step
|
|
102
|
+
// (`gh pr view --json state`, `unzip -d dir`) is not this request's body.
|
|
103
|
+
const steps = splitTopLevel(command);
|
|
104
|
+
const step = steps.find((s) => /\b(?:curl|wget)\b/.test(s) && isMutatingCurlStep(s));
|
|
105
|
+
if (!step)
|
|
106
|
+
return null;
|
|
107
|
+
const cmd = ` ${step}`;
|
|
100
108
|
// `(?:^|\s)` not `\b`: `-X` is preceded by whitespace, and `\b` requires a
|
|
101
109
|
// word char before the `-`, so `\b-X` never matches the usual ` -X DELETE`.
|
|
102
110
|
const methodM = cmd.match(/(?:^|\s)-X\s*(DELETE|POST|PUT|PATCH)\b|(?:^|\s)--request[=\s]+(DELETE|POST|PUT|PATCH)\b/i);
|
|
103
|
-
const hasBody = /\s-d[\s=]|\s--data(?:-raw|-binary|-urlencode|-ascii)?[\s=]|\s-F[\s=]|\s--form[\s=]|\s(?:-T|--upload-file)[\s=]|\s--json[\s=]/.test(cmd);
|
|
104
|
-
if (!methodM && !hasBody)
|
|
105
|
-
return null;
|
|
106
111
|
const method = (methodM?.[1] || methodM?.[2] || "POST").toUpperCase();
|
|
107
112
|
const url = cmd.match(/https?:\/\/[^\s'"]+/)?.[0] || "";
|
|
108
113
|
const host = url ? extractHost(url) : "URL";
|
|
@@ -117,10 +122,15 @@ function summarizeMutatingCurl(cmd) {
|
|
|
117
122
|
target: endpoint,
|
|
118
123
|
body: payload !== undefined
|
|
119
124
|
? truncateBody(payload)
|
|
120
|
-
:
|
|
125
|
+
: command.length > COMMAND_INLINE_MAX ? truncateBody(command) : undefined,
|
|
121
126
|
kind,
|
|
122
127
|
};
|
|
123
128
|
}
|
|
129
|
+
function isMutatingCurlStep(step) {
|
|
130
|
+
const s = ` ${step}`;
|
|
131
|
+
return /(?:^|\s)-X\s*(DELETE|POST|PUT|PATCH)\b|(?:^|\s)--request[=\s]+(DELETE|POST|PUT|PATCH)\b/i.test(s) ||
|
|
132
|
+
/\s-d[\s=]|\s--data(?:-raw|-binary|-urlencode|-ascii)?[\s=]|\s-F[\s=]|\s--form[\s=]|\s(?:-T|--upload-file)[\s=]|\s--json[\s=]/.test(s);
|
|
133
|
+
}
|
|
124
134
|
/** Path (+ query) of a URL, or undefined for a bare origin. */
|
|
125
135
|
function extractPath(url) {
|
|
126
136
|
try {
|
|
@@ -132,18 +142,38 @@ function extractPath(url) {
|
|
|
132
142
|
return undefined;
|
|
133
143
|
}
|
|
134
144
|
}
|
|
135
|
-
/**
|
|
145
|
+
/**
|
|
146
|
+
* The request body curl sends, from every body flag in order: `-d`/`--data*`
|
|
147
|
+
* values joined with `&` (as curl joins them), `--json` values joined as-is,
|
|
148
|
+
* and one line per `-F`/`--form` part. Only the first flag used to count, so
|
|
149
|
+
* `-d charge=ch_1 -d amount=4900` lost the amount.
|
|
150
|
+
*/
|
|
136
151
|
function extractCurlPayload(cmd) {
|
|
137
|
-
const
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
const
|
|
141
|
-
|
|
152
|
+
const data = [];
|
|
153
|
+
const json = [];
|
|
154
|
+
const form = [];
|
|
155
|
+
const re = /\s(-d|--data(?:-raw|-binary|-urlencode|-ascii)?|--json|-F|--form)(?:\s+|=)(?:'([^']*)'|"((?:[^"\\]|\\.)*)"|([^\s'"|;&]+))/g;
|
|
156
|
+
for (const m of cmd.matchAll(re)) {
|
|
157
|
+
const v = m[2] ?? m[3] ?? m[4];
|
|
158
|
+
if (!v)
|
|
159
|
+
continue;
|
|
160
|
+
if (m[1] === "--json")
|
|
161
|
+
json.push(v);
|
|
162
|
+
else if (m[1] === "-F" || m[1] === "--form")
|
|
163
|
+
form.push(v);
|
|
164
|
+
else
|
|
165
|
+
data.push(v);
|
|
166
|
+
}
|
|
167
|
+
const parts = [data.join("&"), json.join(""), form.join("\n")].filter(Boolean);
|
|
168
|
+
return parts.length ? parts.join("\n") : undefined;
|
|
142
169
|
}
|
|
143
170
|
function summarizeBash(command, sizeBytes, cwd) {
|
|
144
171
|
const cmd = (command || "").trim();
|
|
145
172
|
if (!cmd)
|
|
146
173
|
return { title: "Run empty command", kind: "unknown_bash" };
|
|
174
|
+
const compound = summarizeCompoundBash(cmd, sizeBytes, cwd);
|
|
175
|
+
if (compound)
|
|
176
|
+
return compound;
|
|
147
177
|
// SQL detection runs before shell-write detection so that inline-interpreter
|
|
148
178
|
// payloads (`node -e "..."`, `python -c "..."`) aren't misread as shell
|
|
149
179
|
// redirects. JS arrow functions (`t => t.name`) and similar `=>` constructs
|
|
@@ -222,6 +252,9 @@ function summarizeBash(command, sizeBytes, cwd) {
|
|
|
222
252
|
const m = cmd.match(/-m\s+["']([^"'$]+)["']/);
|
|
223
253
|
return m ? { title: `Git commit "${truncate(m[1], 60)}"`, kind: "git_commit" } : { title: "Git commit", kind: "git_commit" };
|
|
224
254
|
}
|
|
255
|
+
const gh = summarizeGh(cmd);
|
|
256
|
+
if (gh)
|
|
257
|
+
return gh;
|
|
225
258
|
// gh pr create — reversible (PRs can be closed). Extract --title when present.
|
|
226
259
|
if (/\bgh\s+pr\s+create\b/.test(cmd)) {
|
|
227
260
|
const m = cmd.match(/--title\s+["']([^"']+)["']/);
|
|
@@ -292,6 +325,16 @@ function summarizeBash(command, sizeBytes, cwd) {
|
|
|
292
325
|
const dockerRm = cmd.match(/\bdocker\s+rm\s+(\S+)/);
|
|
293
326
|
if (dockerRm)
|
|
294
327
|
return { title: "Remove Docker container", target: dockerRm[1], kind: "docker_rm" };
|
|
328
|
+
// Railway: deploys and tear-downs of a live service.
|
|
329
|
+
const railway = cmd.match(/\brailway\s+(up|deploy|redeploy|down|delete)\b(.*)$/s);
|
|
330
|
+
if (railway) {
|
|
331
|
+
const service = railway[2].match(/\s(?:-s|--service)[\s=]+(\S+)/)?.[1];
|
|
332
|
+
const env = railway[2].match(/\s(?:-e|--environment)[\s=]+(\S+)/)?.[1];
|
|
333
|
+
const verb = railway[1] === "down" ? "Remove the latest Railway deployment"
|
|
334
|
+
: railway[1] === "delete" ? "Delete the Railway project"
|
|
335
|
+
: railway[1] === "redeploy" ? "Redeploy on Railway" : "Deploy to Railway";
|
|
336
|
+
return { title: verb, target: service, annotation: env ? `(${env})` : undefined, kind: "deploy" };
|
|
337
|
+
}
|
|
295
338
|
// npm / npx
|
|
296
339
|
const npmScript = cmd.match(/\bnpm\s+run\s+(\S+)/);
|
|
297
340
|
if (npmScript)
|
|
@@ -319,6 +362,108 @@ function summarizeBash(command, sizeBytes, cwd) {
|
|
|
319
362
|
return { title: "Run command", body: truncateBody(cmd), kind: "unknown_bash" };
|
|
320
363
|
return { title: cmd, kind: "unknown_bash" };
|
|
321
364
|
}
|
|
365
|
+
/**
|
|
366
|
+
* A command of several steps (`;`, `&&`, `||`, newlines) takes its title from
|
|
367
|
+
* the step that set the tier, so `gh pr merge … ; gh pr view --json … ; curl
|
|
368
|
+
* -X POST …` reads "POST request to api.oked.ai", not a title built from bits
|
|
369
|
+
* of three steps. Other steps that need approval on their own are listed in the
|
|
370
|
+
* subline. Returns null when no step needs approval, or when the tier comes
|
|
371
|
+
* from a pattern that spans steps (`curl … | sh`): the whole-command rules
|
|
372
|
+
* below describe those.
|
|
373
|
+
*/
|
|
374
|
+
function summarizeCompoundBash(cmd, sizeBytes, cwd) {
|
|
375
|
+
const steps = splitTopLevel(cmd, { pipes: false });
|
|
376
|
+
if (steps.length < 2)
|
|
377
|
+
return null;
|
|
378
|
+
const tiers = steps.map((s) => classify("Bash", { command: s }));
|
|
379
|
+
const rank = tiers.map((t) => TIER_ORDER[t]);
|
|
380
|
+
const top = Math.max(...rank);
|
|
381
|
+
if (top < TIER_ORDER.review)
|
|
382
|
+
return null;
|
|
383
|
+
if (TIER_ORDER[classify("Bash", { command: cmd })] !== top)
|
|
384
|
+
return null;
|
|
385
|
+
const lead = rank.indexOf(top);
|
|
386
|
+
const step = steps[lead];
|
|
387
|
+
// npm publish reads the package.json a preceding `cd` points at.
|
|
388
|
+
const r = (/\bnpm\s+publish\b/.test(step) && summarizeNpmPublish(cmd, cwd)) || summarizeBash(step, sizeBytes, cwd);
|
|
389
|
+
const also = [...new Set(steps
|
|
390
|
+
.filter((_, i) => i !== lead && rank[i] >= TIER_ORDER.review)
|
|
391
|
+
.map((s) => describeStep(s, cwd)))].filter((t) => t !== describeStep(step, cwd));
|
|
392
|
+
// The body shows the steps that need approval, not the setup and polling
|
|
393
|
+
// around them; the footnote says there are other steps.
|
|
394
|
+
const risky = steps.filter((_, i) => rank[i] >= TIER_ORDER.review);
|
|
395
|
+
const quiet = steps.length - risky.length;
|
|
396
|
+
return {
|
|
397
|
+
...r,
|
|
398
|
+
subline: also.length ? `Also: ${also.join("; ")}` : r.subline,
|
|
399
|
+
body: r.body ?? truncateBody(risky.join("\n")),
|
|
400
|
+
footnote: r.footnote ?? (quiet ? "Other steps in this command need no approval" : undefined),
|
|
401
|
+
};
|
|
402
|
+
}
|
|
403
|
+
function describeStep(step, cwd) {
|
|
404
|
+
const r = summarizeBash(step, undefined, cwd);
|
|
405
|
+
return r.target && !r.title.includes(r.target) ? `${r.title} ${r.target}` : r.title;
|
|
406
|
+
}
|
|
407
|
+
/** GitHub CLI writes: which PR, issue or release, in which repo. */
|
|
408
|
+
function summarizeGh(cmd) {
|
|
409
|
+
const m = cmd.match(/\bgh\s+(pr|issue|release|repo|workflow|run|secret|variable|api)\s+(\S+)(.*)$/s);
|
|
410
|
+
if (!m)
|
|
411
|
+
return null;
|
|
412
|
+
const [, noun, verb, rest] = m;
|
|
413
|
+
const url = rest.match(/https:\/\/github\.com\/([^/\s]+\/[^/\s]+)\/(?:pull|issues)\/(\d+)/);
|
|
414
|
+
const repoFlag = rest.match(/\s(?:-R|--repo)[\s=]+(\S+)/)?.[1];
|
|
415
|
+
const repo = url?.[1] ?? repoFlag;
|
|
416
|
+
const num = url?.[2] ?? rest.match(/^\s+#?(\d+)\b/)?.[1];
|
|
417
|
+
const ref = num ? `#${num}` : "";
|
|
418
|
+
const where = repo ? ` in ${repo}` : "";
|
|
419
|
+
if (noun === "pr" && verb === "merge") {
|
|
420
|
+
const how = /\s(?:--squash|-s)\b/.test(rest) ? "squash" : /\s(?:--rebase|-r)\b/.test(rest) ? "rebase" : undefined;
|
|
421
|
+
const auto = /\s--auto\b/.test(rest);
|
|
422
|
+
return {
|
|
423
|
+
title: `Merge PR ${ref}${where}`.replace(/\s+/g, " ").trim(),
|
|
424
|
+
annotation: [how, auto ? "when checks pass" : undefined, /\s(?:--delete-branch|-d)\b/.test(rest) ? "deletes branch" : undefined]
|
|
425
|
+
.filter(Boolean).join(", ") || undefined,
|
|
426
|
+
kind: "git_pr_merge",
|
|
427
|
+
};
|
|
428
|
+
}
|
|
429
|
+
if (noun === "api") {
|
|
430
|
+
const args = ` ${verb}${rest}`;
|
|
431
|
+
const method = args.match(/\s(?:-X|--method)(?:\s+|=)?([A-Za-z]+)\b/)?.[1]?.toUpperCase();
|
|
432
|
+
// The endpoint is the first argument that is not a flag or a flag's value.
|
|
433
|
+
const endpoint = args
|
|
434
|
+
.replace(/\s(?:-X|--method|-H|--header|-f|-F|--field|--raw-field|--input|-q|--jq|-t|--template|--hostname|-p|--preview|--cache)(?:\s+|=)(?:'[^']*'|"(?:[^"\\]|\\.)*"|\S+)/g, " ")
|
|
435
|
+
.split(/\s+/).find((w) => w && !w.startsWith("-"))?.replace(/^['"]|['"]$/g, "");
|
|
436
|
+
if (endpoint === "graphql") {
|
|
437
|
+
const mutation = /\bmutation\b/.test(args);
|
|
438
|
+
return { title: mutation ? "Change data via GitHub GraphQL API" : "Query GitHub GraphQL API", body: truncateBody(cmd), kind: mutation ? "http_post" : "http_get" };
|
|
439
|
+
}
|
|
440
|
+
const m2 = method ?? (/\s(?:-f|-F|--field|--raw-field|--input)(?:\s|=)/.test(args) ? "POST" : "GET");
|
|
441
|
+
return {
|
|
442
|
+
title: `${m2} request to GitHub API`,
|
|
443
|
+
target: endpoint,
|
|
444
|
+
body: truncateBody(cmd),
|
|
445
|
+
kind: m2 === "DELETE" ? "http_delete" : m2 === "PUT" ? "http_put" : m2 === "GET" ? "http_get" : "http_post",
|
|
446
|
+
};
|
|
447
|
+
}
|
|
448
|
+
const outward = new Set(["merge", "close", "reopen", "comment", "review", "edit", "ready", "delete", "archive", "rename",
|
|
449
|
+
"create", "upload", "set", "run", "cancel", "rerun", "transfer", "fork", "enable", "disable"]);
|
|
450
|
+
if (!outward.has(verb) || (noun === "pr" && verb === "create"))
|
|
451
|
+
return null;
|
|
452
|
+
const thing = { pr: "PR", issue: "issue", release: "release", repo: "repo", workflow: "workflow", run: "workflow run", secret: "secret", variable: "variable" }[noun] ?? noun;
|
|
453
|
+
const name = noun === "release" || noun === "secret" || noun === "variable" || noun === "workflow"
|
|
454
|
+
? rest.match(/^\s+([^\s-][^\s]*)/)?.[1] : undefined;
|
|
455
|
+
const body = rest.match(/\s(?:-b|--body)[\s=]+(?:'([^']*)'|"((?:[^"\\]|\\.)*)")/);
|
|
456
|
+
const obj = `${thing}${ref ? ` ${ref}` : name ? ` ${name}` : ""}`;
|
|
457
|
+
const phrase = verb === "comment" ? `Comment on ${obj}`
|
|
458
|
+
: verb === "ready" ? `Mark ${obj} ready for review`
|
|
459
|
+
: verb === "set" ? `Set ${obj}`
|
|
460
|
+
: `${verb.charAt(0).toUpperCase()}${verb.slice(1)} ${obj}`;
|
|
461
|
+
return {
|
|
462
|
+
title: `${phrase}${where}`,
|
|
463
|
+
body: body ? truncateBody(body[1] ?? body[2] ?? "") : undefined,
|
|
464
|
+
kind: noun === "pr" ? "git_pr_write" : "gh_write",
|
|
465
|
+
};
|
|
466
|
+
}
|
|
322
467
|
/**
|
|
323
468
|
* `npm publish` → which package and version, dist-tag, access, registry.
|
|
324
469
|
* Name/version come from the package.json the publish will read: the cwd,
|
|
@@ -511,6 +656,105 @@ function sqlFromInterpreterBody(body) {
|
|
|
511
656
|
return extracted;
|
|
512
657
|
return DB_LIBRARY_RE.test(body) ? body : null;
|
|
513
658
|
}
|
|
659
|
+
/**
|
|
660
|
+
* Shell words of `s` up to the first unquoted operator (| ; & < > or a
|
|
661
|
+
* newline), with quotes removed and `\"`-style escapes resolved. `quoted` marks
|
|
662
|
+
* a word that had a quoted part. Undefined when a quote is never closed.
|
|
663
|
+
*/
|
|
664
|
+
function shellWords(s) {
|
|
665
|
+
const words = [];
|
|
666
|
+
let i = 0;
|
|
667
|
+
while (i < s.length) {
|
|
668
|
+
while (i < s.length && (s[i] === " " || s[i] === "\t"))
|
|
669
|
+
i++;
|
|
670
|
+
if (i >= s.length || /[|;&<>\n]/.test(s[i]))
|
|
671
|
+
break;
|
|
672
|
+
let text = "";
|
|
673
|
+
let quoted = false;
|
|
674
|
+
while (i < s.length && !/[\s|;&<>]/.test(s[i])) {
|
|
675
|
+
const c = s[i];
|
|
676
|
+
if (c === "'") {
|
|
677
|
+
const end = s.indexOf("'", i + 1);
|
|
678
|
+
if (end < 0)
|
|
679
|
+
return undefined;
|
|
680
|
+
text += s.slice(i + 1, end);
|
|
681
|
+
i = end + 1;
|
|
682
|
+
quoted = true;
|
|
683
|
+
}
|
|
684
|
+
else if (c === '"') {
|
|
685
|
+
let j = i + 1;
|
|
686
|
+
while (j < s.length && s[j] !== '"') {
|
|
687
|
+
if (s[j] === "\\" && /["\\$`]/.test(s[j + 1] ?? "")) {
|
|
688
|
+
text += s[j + 1];
|
|
689
|
+
j += 2;
|
|
690
|
+
}
|
|
691
|
+
else {
|
|
692
|
+
text += s[j++];
|
|
693
|
+
}
|
|
694
|
+
}
|
|
695
|
+
if (j >= s.length)
|
|
696
|
+
return undefined;
|
|
697
|
+
i = j + 1;
|
|
698
|
+
quoted = true;
|
|
699
|
+
}
|
|
700
|
+
else if (c === "\\" && i + 1 < s.length) {
|
|
701
|
+
text += s[i + 1];
|
|
702
|
+
i += 2;
|
|
703
|
+
}
|
|
704
|
+
else {
|
|
705
|
+
text += c;
|
|
706
|
+
i++;
|
|
707
|
+
}
|
|
708
|
+
}
|
|
709
|
+
words.push({ text, quoted });
|
|
710
|
+
}
|
|
711
|
+
return words;
|
|
712
|
+
}
|
|
713
|
+
// The flag that carries a statement, per SQL CLI. psql's `-e` is --echo-queries
|
|
714
|
+
// and takes no value, so it must not count there.
|
|
715
|
+
const SQL_CLI_STATEMENT_FLAGS = {
|
|
716
|
+
psql: { short: "-c", long: "--command" },
|
|
717
|
+
mysql: { short: "-e", long: "--execute" },
|
|
718
|
+
mariadb: { short: "-e", long: "--execute" },
|
|
719
|
+
sqlite3: { long: "-cmd" },
|
|
720
|
+
sqlite: { long: "-cmd" },
|
|
721
|
+
};
|
|
722
|
+
/**
|
|
723
|
+
* The SQL a psql / mysql / sqlite3 invocation runs, from its arguments.
|
|
724
|
+
* Every statement flag counts (`psql -c "SELECT 1" -c "DROP TABLE t"` runs
|
|
725
|
+
* both), so a harmless first statement can't hide a destructive one. With no
|
|
726
|
+
* flag, quoted positional arguments that read as SQL (`sqlite3 db "…"`), else
|
|
727
|
+
* a trailing quoted argument as before. Undefined when the arguments can't be
|
|
728
|
+
* read (unbalanced quotes), so the caller can fall back.
|
|
729
|
+
*/
|
|
730
|
+
function sqlFromCliArgs(tool, args) {
|
|
731
|
+
const words = shellWords(args);
|
|
732
|
+
if (!words)
|
|
733
|
+
return undefined;
|
|
734
|
+
const flags = SQL_CLI_STATEMENT_FLAGS[tool];
|
|
735
|
+
const statements = [];
|
|
736
|
+
for (let k = 0; k < words.length; k++) {
|
|
737
|
+
const w = words[k].text;
|
|
738
|
+
if (w === flags.long || (flags.short && w === flags.short)) {
|
|
739
|
+
if (k + 1 < words.length)
|
|
740
|
+
statements.push(words[++k].text);
|
|
741
|
+
}
|
|
742
|
+
else if (w.startsWith(flags.long + "=")) {
|
|
743
|
+
statements.push(w.slice(flags.long.length + 1));
|
|
744
|
+
}
|
|
745
|
+
else if (flags.short && words[k].quoted && w.length > 2 && w.startsWith(flags.short)) {
|
|
746
|
+
statements.push(w.slice(2)); // -c"SELECT …"
|
|
747
|
+
}
|
|
748
|
+
}
|
|
749
|
+
if (statements.length)
|
|
750
|
+
return statements.join("\n");
|
|
751
|
+
const quoted = words.filter(w => w.quoted).map(w => w.text);
|
|
752
|
+
const sqlish = quoted.filter(q => SQL_KEYWORDS_RE.test(q));
|
|
753
|
+
if (sqlish.length)
|
|
754
|
+
return sqlish.join("\n");
|
|
755
|
+
const last = words[words.length - 1];
|
|
756
|
+
return last?.quoted && words.length > 1 && /["']\s*$/.test(args) ? last.text : null;
|
|
757
|
+
}
|
|
514
758
|
export function findSqlInCommand(cmd) {
|
|
515
759
|
// Inline interpreter flags: node -e, python -c, ruby -e, perl -e. Anchored to
|
|
516
760
|
// a command position so a SQL-looking string elsewhere doesn't match.
|
|
@@ -521,15 +765,25 @@ export function findSqlInCommand(cmd) {
|
|
|
521
765
|
if (sql)
|
|
522
766
|
return sql;
|
|
523
767
|
}
|
|
524
|
-
// psql -c "..." / mysql -e "..." / sqlite3 db "..." —
|
|
525
|
-
//
|
|
526
|
-
//
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
const
|
|
531
|
-
if (
|
|
532
|
-
return
|
|
768
|
+
// psql -c "..." / mysql -e "..." / sqlite3 db "..." — read the arguments as
|
|
769
|
+
// shell words, so a quoted connection string before the statement
|
|
770
|
+
// (`psql "$DATABASE_URL" -c "DELETE …"`) isn't swallowed into it. Anchored to
|
|
771
|
+
// the start of the command so "psql"/"mysql" appearing inside an argument
|
|
772
|
+
// (another tool's --body, etc.) can't trigger a false SQL match.
|
|
773
|
+
const cli = cmd.match(/^(?:\s*\w+=\S+\s+)*(?:sudo\s+)?(psql|mysql|sqlite3?|mariadb)\b/i);
|
|
774
|
+
const fromArgs = cli ? sqlFromCliArgs(cli[1].toLowerCase(), cmd.slice(cli[0].length)) : null;
|
|
775
|
+
if (fromArgs)
|
|
776
|
+
return fromArgs;
|
|
777
|
+
if (fromArgs === undefined) {
|
|
778
|
+
// Unbalanced quotes: fall back to the outer-quoted span.
|
|
779
|
+
const dq = cmd.match(/^(?:\s*\w+=\S+\s+)*(?:sudo\s+)?(?:psql|mysql|sqlite3?|mariadb)\b[^"]*"([\s\S]+?)"\s*$/i);
|
|
780
|
+
if (dq)
|
|
781
|
+
return dq[1];
|
|
782
|
+
const sq = cmd.match(/^(?:\s*\w+=\S+\s+)*(?:sudo\s+)?(?:psql|mysql|sqlite3?|mariadb)\b[^']*'([\s\S]+?)'\s*$/i);
|
|
783
|
+
if (sq)
|
|
784
|
+
return sq[1];
|
|
785
|
+
}
|
|
786
|
+
// No statement in the arguments: a heredoc may still feed one (below).
|
|
533
787
|
// Heredoc-piped script: <<EOF / <<'EOF' / <<"EOF" / <<-EOF. Only when the
|
|
534
788
|
// command (outside the body) actually feeds the heredoc to a SQL CLI or
|
|
535
789
|
// interpreter — otherwise a `gh`/`cat`/`mail` heredoc whose body merely
|
|
@@ -896,6 +1150,9 @@ function summarizeMcp(toolName, input) {
|
|
|
896
1150
|
? { title: "Give session access to folder", target: dir, footnote: "Claude can read and change files in this folder", kind: "folder_access" }
|
|
897
1151
|
: { title: "Ask you to pick a folder for this session", kind: "folder_access" };
|
|
898
1152
|
}
|
|
1153
|
+
const desktop = summarizeDesktopApp(parts[1] || "", tool, input);
|
|
1154
|
+
if (desktop)
|
|
1155
|
+
return desktop;
|
|
899
1156
|
const browser = parts.slice(1, -1).find((p) => p === "Claude_Browser" || p === "claude-in-chrome");
|
|
900
1157
|
if (browser)
|
|
901
1158
|
return summarizeBrowser(parts[parts.length - 1] || "", input, browser);
|
|
@@ -963,10 +1220,31 @@ function summarizeMcp(toolName, input) {
|
|
|
963
1220
|
return { title: `Submit ${selector} via ${server}`, kind: "mcp_submit" };
|
|
964
1221
|
}
|
|
965
1222
|
if (tool.startsWith("list_") || tool.startsWith("get_") || tool.startsWith("search_")) {
|
|
966
|
-
return { title: `${
|
|
1223
|
+
return { title: `${toSentence(tool)} via ${server}`, kind: "unknown_tool" };
|
|
967
1224
|
}
|
|
968
1225
|
return { title: `${toSentence(tool)} via ${server}`, kind: "unknown_tool" };
|
|
969
1226
|
}
|
|
1227
|
+
/** Desktop app tools whose name alone does not say what they do. */
|
|
1228
|
+
function summarizeDesktopApp(server, tool, input) {
|
|
1229
|
+
const str = (v) => (typeof v === "string" && v.trim() ? v.trim() : undefined);
|
|
1230
|
+
if (server === "ccd_turn" && tool === "update_plan") {
|
|
1231
|
+
return { title: "Update the task list in the Claude app", kind: "session_housekeeping" };
|
|
1232
|
+
}
|
|
1233
|
+
if (server === "ccd_turn" && tool === "wrap_up") {
|
|
1234
|
+
return { title: "Show the end-of-turn summary in the Claude app", body: str(input.recap), kind: "session_housekeeping" };
|
|
1235
|
+
}
|
|
1236
|
+
if (server === "ccd_session" && (tool === "start_session" || tool === "hand_off_to_session")) {
|
|
1237
|
+
const where = input.target === "cloud" ? "in the cloud" : input.target === "ssh" ? `on ${str(input.host) ?? "an SSH host"}` : undefined;
|
|
1238
|
+
const title = tool === "hand_off_to_session" ? "Move this task to a new Claude session" : "Start a new Claude session";
|
|
1239
|
+
return {
|
|
1240
|
+
title: where ? `${title} ${where}` : title,
|
|
1241
|
+
target: str(input.title),
|
|
1242
|
+
body: str(input.prompt) ?? str(input.remaining_plan),
|
|
1243
|
+
kind: "session_start",
|
|
1244
|
+
};
|
|
1245
|
+
}
|
|
1246
|
+
return null;
|
|
1247
|
+
}
|
|
970
1248
|
function identifyTarget(input) {
|
|
971
1249
|
const id = input.id ?? input.name ?? input.path ?? input.target ?? input.repo ?? input.repository ?? null;
|
|
972
1250
|
if (id == null)
|
|
@@ -1210,8 +1488,11 @@ function formatByteCount(bytes) {
|
|
|
1210
1488
|
return `${Math.round(bytes / 1024)} KB`;
|
|
1211
1489
|
return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
|
|
1212
1490
|
}
|
|
1491
|
+
// Words shown in capitals. Only known acronyms: uppercasing every short word
|
|
1492
|
+
// turned "wrap_up" into "Wrap UP" and "get_repo" into "GET repo".
|
|
1493
|
+
const ACRONYMS = new Set(["pr", "prs", "url", "api", "sql", "ci", "id", "ids", "ui", "dns", "ssh", "sms", "pdf", "csv", "json", "html", "css", "aws", "gcp", "db", "vm", "ip", "mcp", "otp", "llm"]);
|
|
1213
1494
|
function toWords(snake) {
|
|
1214
|
-
return snake.replace(/_/g, " ").split(" ").map((w) => (w.
|
|
1495
|
+
return snake.replace(/_/g, " ").split(" ").map((w) => (ACRONYMS.has(w.toLowerCase()) ? w.toUpperCase() : w)).join(" ");
|
|
1215
1496
|
}
|
|
1216
1497
|
// "set_auto_merge" -> "Set auto merge", "bind_pr" -> "Bind PR": the first word
|
|
1217
1498
|
// is a verb, so it is not read as an acronym.
|
package/dist/kinds.d.ts
CHANGED
|
@@ -6,5 +6,5 @@
|
|
|
6
6
|
* pattern maps to a kind, so historical rows stay attributable to the
|
|
7
7
|
* classifier that produced them.
|
|
8
8
|
*/
|
|
9
|
-
export declare const CLASSIFIER_VERSION = "
|
|
10
|
-
export type OperationKind = "file_create" | "file_append" | "file_edit" | "file_touch" | "file_copy" | "file_move" | "file_delete" | "sql_drop" | "sql_truncate" | "sql_alter" | "sql_create" | "sql_delete_rows" | "sql_delete_all_rows" | "sql_update_rows" | "sql_update_every_row" | "sql_insert" | "sql_query" | "git_push" | "git_force_push" | "git_reset_hard" | "git_clean" | "git_checkout" | "git_restore" | "git_commit" | "git_pr_create" | "ssh_remote" | "http_get" | "http_post" | "http_put" | "http_delete" | "http_pipe_to_shell" | "docker_up" | "docker_down" | "docker_rm" | "docker_rmi" | "docker_prune" | "npm_install" | "npm_run" | "npm_test" | "npm_publish" | "npm_unpublish" | "npx_deploy" | "kill_process" | "sudo" | "chmod_777" | "email_send" | "email_delete" | "email_purge" | "payment_charge" | "payment_create" | "chat_message" | "mcp_delete" | "mcp_update" | "mcp_create" | "mcp_post" | "mcp_publish" | "mcp_send" | "mcp_submit_form" | "mcp_fill" | "mcp_submit" | "mcp_query" | "browser_navigate" | "browser_interact" | "browser_script" | "browser_dev_server" | "folder_access" | "session_control" | "worktree" | "schedule" | "agent_message" | "web_fetch" | "monitor" | "artifact" | "agent_launch" | "shell_pipeline" | "unknown_bash" | "unknown_tool";
|
|
9
|
+
export declare const CLASSIFIER_VERSION = "v3";
|
|
10
|
+
export type OperationKind = "file_create" | "file_append" | "file_edit" | "file_touch" | "file_copy" | "file_move" | "file_delete" | "sql_drop" | "sql_truncate" | "sql_alter" | "sql_create" | "sql_delete_rows" | "sql_delete_all_rows" | "sql_update_rows" | "sql_update_every_row" | "sql_insert" | "sql_query" | "git_push" | "git_force_push" | "git_reset_hard" | "git_clean" | "git_checkout" | "git_restore" | "git_commit" | "git_pr_create" | "git_pr_merge" | "git_pr_write" | "gh_write" | "deploy" | "ssh_remote" | "http_get" | "http_post" | "http_put" | "http_delete" | "http_pipe_to_shell" | "docker_up" | "docker_down" | "docker_rm" | "docker_rmi" | "docker_prune" | "npm_install" | "npm_run" | "npm_test" | "npm_publish" | "npm_unpublish" | "npx_deploy" | "kill_process" | "sudo" | "chmod_777" | "email_send" | "email_delete" | "email_purge" | "payment_charge" | "payment_create" | "chat_message" | "mcp_delete" | "mcp_update" | "mcp_create" | "mcp_post" | "mcp_publish" | "mcp_send" | "mcp_submit_form" | "mcp_fill" | "mcp_submit" | "mcp_query" | "browser_navigate" | "browser_interact" | "browser_script" | "browser_dev_server" | "folder_access" | "session_control" | "session_housekeeping" | "session_start" | "worktree" | "schedule" | "agent_message" | "web_fetch" | "monitor" | "artifact" | "agent_launch" | "shell_pipeline" | "unknown_bash" | "unknown_tool";
|
package/dist/kinds.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oked/sdk",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.6",
|
|
4
4
|
"description": "OKed SDK - human approval layer for AI agents",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"access": "public"
|
|
46
46
|
},
|
|
47
47
|
"dependencies": {
|
|
48
|
-
"@oked/receipt-core": "0.6.
|
|
48
|
+
"@oked/receipt-core": "0.6.6"
|
|
49
49
|
},
|
|
50
50
|
"devDependencies": {
|
|
51
51
|
"@types/node": "^22.13.10",
|