@scotthuang/agent-knock-knock 0.12.10 → 0.12.11
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/CHANGELOG.md +17 -0
- package/dist/src/claude-local-transcript-provider.d.ts +21 -1
- package/dist/src/claude-local-transcript-provider.js +121 -15
- package/dist/src/claude-local-transcript-provider.js.map +1 -1
- package/dist/src/cli-core.js +1311 -129
- package/dist/src/cli-core.js.map +1 -1
- package/dist/src/terminal-process-source.d.ts +7 -0
- package/dist/src/terminal-process-source.js +50 -1
- package/dist/src/terminal-process-source.js.map +1 -1
- package/package.json +1 -1
|
@@ -6,6 +6,12 @@ export interface ProcessCommandResult {
|
|
|
6
6
|
error?: Error;
|
|
7
7
|
}
|
|
8
8
|
export interface TerminalProcessSource {
|
|
9
|
+
/**
|
|
10
|
+
* True only when an empty result comes from one complete, integrity-checked
|
|
11
|
+
* operating-system process inventory and may therefore prove PID absence.
|
|
12
|
+
* User-supplied/static discovery snapshots deliberately omit this marker.
|
|
13
|
+
*/
|
|
14
|
+
readonly completeInventoryAuthority?: true;
|
|
9
15
|
listProcessSnapshots(isCandidate?: (snapshot: TerminalProcessSnapshot) => boolean, options?: {
|
|
10
16
|
includeCwd?: boolean;
|
|
11
17
|
includeAncestors?: boolean;
|
|
@@ -20,6 +26,7 @@ export declare class StaticTerminalProcessSource implements TerminalProcessSourc
|
|
|
20
26
|
}): Promise<TerminalProcessSnapshot[]>;
|
|
21
27
|
}
|
|
22
28
|
export declare class SystemTerminalProcessSource implements TerminalProcessSource {
|
|
29
|
+
readonly completeInventoryAuthority: true;
|
|
23
30
|
private readonly runCommand;
|
|
24
31
|
constructor(options?: {
|
|
25
32
|
runCommand?: (command: string, args: string[]) => ProcessCommandResult;
|
|
@@ -11,6 +11,7 @@ export class StaticTerminalProcessSource {
|
|
|
11
11
|
}
|
|
12
12
|
}
|
|
13
13
|
export class SystemTerminalProcessSource {
|
|
14
|
+
completeInventoryAuthority = true;
|
|
14
15
|
runCommand;
|
|
15
16
|
constructor(options = {}) {
|
|
16
17
|
this.runCommand = options.runCommand ?? runProcessCommand;
|
|
@@ -20,7 +21,7 @@ export class SystemTerminalProcessSource {
|
|
|
20
21
|
if (ps.status !== 0) {
|
|
21
22
|
throw new Error(ps.stderr || ps.error?.message || "ps failed");
|
|
22
23
|
}
|
|
23
|
-
const snapshots =
|
|
24
|
+
const snapshots = parseCompletePsProcessSnapshots(ps.stdout);
|
|
24
25
|
const candidates = snapshots.filter(isCandidate);
|
|
25
26
|
if (candidates.length === 0) {
|
|
26
27
|
return [];
|
|
@@ -47,6 +48,54 @@ export class SystemTerminalProcessSource {
|
|
|
47
48
|
}));
|
|
48
49
|
}
|
|
49
50
|
}
|
|
51
|
+
/**
|
|
52
|
+
* Parse one complete `ps -axo pid,ppid,etime,command` observation. This is
|
|
53
|
+
* intentionally stricter than the public best-effort parser below: callers
|
|
54
|
+
* may use an empty result as process-death authority, so malformed or
|
|
55
|
+
* truncated output must never collapse into an apparently empty inventory.
|
|
56
|
+
*/
|
|
57
|
+
function parseCompletePsProcessSnapshots(output) {
|
|
58
|
+
if (typeof output !== "string" || output.length === 0) {
|
|
59
|
+
throw new Error("ps returned an empty process inventory");
|
|
60
|
+
}
|
|
61
|
+
if (!/\r?\n$/u.test(output)) {
|
|
62
|
+
throw new Error("ps returned a truncated process inventory");
|
|
63
|
+
}
|
|
64
|
+
const lines = output.split(/\r?\n/u);
|
|
65
|
+
const header = lines.shift()?.trim();
|
|
66
|
+
if (!header || !/^PID\s+PPID\s+(?:ELAPSED|ETIME)\s+COMMAND$/u.test(header)) {
|
|
67
|
+
throw new Error("ps returned an unexpected process inventory header");
|
|
68
|
+
}
|
|
69
|
+
const snapshots = [];
|
|
70
|
+
for (const line of lines) {
|
|
71
|
+
if (line.trim().length === 0) {
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
const match = /^\s*(\d+)\s+(\d+)\s+(\S+)\s+(.+?)\s*$/u.exec(line);
|
|
75
|
+
if (!match) {
|
|
76
|
+
throw new Error("ps returned an unparseable process inventory row");
|
|
77
|
+
}
|
|
78
|
+
const pid = Number(match[1]);
|
|
79
|
+
const ppid = Number(match[2]);
|
|
80
|
+
if (!Number.isSafeInteger(pid) ||
|
|
81
|
+
pid <= 0 ||
|
|
82
|
+
!Number.isSafeInteger(ppid) ||
|
|
83
|
+
ppid < 0 ||
|
|
84
|
+
parseProcessElapsedSeconds(match[3]) === undefined) {
|
|
85
|
+
throw new Error("ps returned an invalid process inventory row");
|
|
86
|
+
}
|
|
87
|
+
snapshots.push({
|
|
88
|
+
pid,
|
|
89
|
+
ppid,
|
|
90
|
+
elapsed: match[3],
|
|
91
|
+
command: match[4]
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
if (snapshots.length === 0) {
|
|
95
|
+
throw new Error("ps returned a header-only process inventory");
|
|
96
|
+
}
|
|
97
|
+
return snapshots;
|
|
98
|
+
}
|
|
50
99
|
function selectedSnapshots(snapshots, candidates, includeAncestors) {
|
|
51
100
|
if (!includeAncestors) {
|
|
52
101
|
return [...candidates];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"terminal-process-source.js","sourceRoot":"","sources":["../../src/terminal-process-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"terminal-process-source.js","sourceRoot":"","sources":["../../src/terminal-process-source.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@scotthuang/agent-knock-knock",
|
|
3
|
-
"version": "0.12.
|
|
3
|
+
"version": "0.12.11",
|
|
4
4
|
"description": "Control local Codex and Claude Code from OpenClaw through shared tmux or Herdr terminals, with seamless human-agent handoff.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|