@scotthuang/agent-knock-knock 0.16.5 → 0.16.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/CHANGELOG.md +8 -0
- package/README.md +2 -2
- package/connectors/deepseek-harness/README.md +20 -6
- package/connectors/pi/README.md +21 -7
- package/dist/src/claude-conversation-routing-cli-adapter.js +8 -2
- package/dist/src/claude-conversation-routing-cli-adapter.js.map +1 -1
- package/dist/src/claude-managed-send-route.js +3 -0
- package/dist/src/claude-managed-send-route.js.map +1 -1
- package/dist/src/claude-terminal-admission.d.ts +28 -0
- package/dist/src/claude-terminal-admission.js +53 -0
- package/dist/src/claude-terminal-admission.js.map +1 -0
- package/dist/src/cli-core.js +2 -1
- package/dist/src/cli-core.js.map +1 -1
- package/dist/src/conversation-usage-guidance.js +24 -1
- package/dist/src/conversation-usage-guidance.js.map +1 -1
- package/dist/src/native-thread-lifecycle-cli-adapter.d.ts +1 -0
- package/dist/src/native-thread-lifecycle-cli-adapter.js +1 -0
- package/dist/src/native-thread-lifecycle-cli-adapter.js.map +1 -1
- package/dist/src/native-thread-lifecycle-cli-contract.d.ts +6 -0
- package/dist/src/native-thread-lifecycle-query-service.js +2 -1
- package/dist/src/native-thread-lifecycle-query-service.js.map +1 -1
- package/dist/src/native-thread-transition-application.d.ts +1 -1
- package/dist/src/native-thread-transition-application.js +23 -1
- package/dist/src/native-thread-transition-application.js.map +1 -1
- package/dist/src/native-thread-transition-verification-adapter.js +5 -10
- package/dist/src/native-thread-transition-verification-adapter.js.map +1 -1
- package/dist/src/semantic-tool-list-projection.js +5 -1
- package/dist/src/semantic-tool-list-projection.js.map +1 -1
- package/dist/src/terminal-command-dispatch-preparation.js +8 -6
- package/dist/src/terminal-command-dispatch-preparation.js.map +1 -1
- package/dist/src/terminal-identity-authority-cli-adapter.js +6 -3
- package/dist/src/terminal-identity-authority-cli-adapter.js.map +1 -1
- package/dist/src/terminal-list-action-policy.js +9 -6
- package/dist/src/terminal-list-action-policy.js.map +1 -1
- package/dist/src/terminal-list-cli-adapter.js +3 -4
- package/dist/src/terminal-list-cli-adapter.js.map +1 -1
- package/dist/src/terminal-list-facts.d.ts +20 -0
- package/dist/src/terminal-list-facts.js +13 -0
- package/dist/src/terminal-list-facts.js.map +1 -1
- package/dist/src/terminal-list-native-identity-recheck.d.ts +3 -0
- package/dist/src/terminal-list-native-identity-recheck.js +9 -0
- package/dist/src/terminal-list-native-identity-recheck.js.map +1 -1
- package/dist/src/terminal-monitor-decision-policy.d.ts +1 -1
- package/dist/src/terminal-permission-control-list-projection.d.ts +1 -1
- package/docs/list-output.md +19 -0
- package/docs/operator-guide.md +26 -0
- package/package.json +1 -1
|
@@ -15,6 +15,19 @@ export function claudePhysicalSendReadinessFromListState(state, options) {
|
|
|
15
15
|
};
|
|
16
16
|
return claudeUserExplicitReadiness(state.screen_excerpt);
|
|
17
17
|
}
|
|
18
|
+
/** Diagnostics do not carry the private transcript anchor or grant a physical fallback. */
|
|
19
|
+
export function claudeListAdmissionProjection(agent, facts, send) {
|
|
20
|
+
if (agent !== "claude")
|
|
21
|
+
return {};
|
|
22
|
+
const missing = { ready: false, reason: "claude_reader_unavailable",
|
|
23
|
+
message: "AKK could not verify the current Claude process through its reader. Check Status and the configured Claude reader, then refresh List and retry." };
|
|
24
|
+
return {
|
|
25
|
+
managed_send_readiness: facts.native.claudeAdmission?.managedSend ?? missing,
|
|
26
|
+
thread_lifecycle_readiness: facts.native.claudeAdmission?.lifecycle ?? missing,
|
|
27
|
+
_claude_managed_send_eligible: send && facts.composer.automatedInputComposerReady &&
|
|
28
|
+
!facts.store.hasOrphanedDispatch && facts.native.claudeAdmission?.managedSend.ready === true
|
|
29
|
+
};
|
|
30
|
+
}
|
|
18
31
|
/**
|
|
19
32
|
* Collect the immutable observation facts for one already-discovered terminal.
|
|
20
33
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"terminal-list-facts.js","sourceRoot":"","sources":["../../src/terminal-list-facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAGpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAe7D,OAAO,EACL,8BAA8B,EAI/B,MAAM,6BAA6B,CAAC;
|
|
1
|
+
{"version":3,"file":"terminal-list-facts.js","sourceRoot":"","sources":["../../src/terminal-list-facts.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,6 +2,7 @@ import type { ActiveTerminalProcess } from "./terminal-agent-adapter.js";
|
|
|
2
2
|
import type { TerminalNativeIdentityObservation } from "./terminal-binding-authority.js";
|
|
3
3
|
import type { ClaudeIdentityRow } from "./terminal-dispatch-execution.js";
|
|
4
4
|
import type { TerminalListInventoryOptions, TerminalListInventoryPorts } from "./terminal-list-inventory.js";
|
|
5
|
+
import { type ClaudeTerminalAdmission } from "./claude-terminal-admission.js";
|
|
5
6
|
export interface TerminalListIdentityRecheck {
|
|
6
7
|
attempted: true;
|
|
7
8
|
status: "resolved" | "unresolved" | "failed";
|
|
@@ -10,6 +11,7 @@ export interface TerminalListNativeIdentitySnapshot {
|
|
|
10
11
|
observation: TerminalNativeIdentityObservation;
|
|
11
12
|
recheck?: TerminalListIdentityRecheck;
|
|
12
13
|
windowRole?: "background_view";
|
|
14
|
+
admission?: ClaudeTerminalAdmission;
|
|
13
15
|
}
|
|
14
16
|
/** Scope reader snapshots to one List invocation, including exact-terminal List. */
|
|
15
17
|
export declare function withClaudeListIdentityRecheck<Options extends TerminalListInventoryOptions>(input: {
|
|
@@ -29,6 +31,7 @@ export declare function withClaudeListIdentityRecheck<Options extends TerminalLi
|
|
|
29
31
|
/** One fresh retry is shared by all unresolved Claude PIDs in this physical scan. */
|
|
30
32
|
export declare function observeClaudeListIdentitySnapshots(input: {
|
|
31
33
|
sessions: readonly ActiveTerminalProcess[];
|
|
34
|
+
claudeHome?: string;
|
|
32
35
|
loadRows(): readonly ClaudeIdentityRow[];
|
|
33
36
|
observeWindowRole?(session: ActiveTerminalProcess): "background_view" | undefined;
|
|
34
37
|
observe(session: ActiveTerminalProcess, rows: readonly ClaudeIdentityRow[]): Promise<TerminalNativeIdentityObservation>;
|
|
@@ -1,11 +1,15 @@
|
|
|
1
|
+
import { observeClaudeTerminalAdmission } from "./claude-terminal-admission.js";
|
|
2
|
+
import { expandHome } from "./cli-command-runtime.js";
|
|
1
3
|
/** Scope reader snapshots to one List invocation, including exact-terminal List. */
|
|
2
4
|
export function withClaudeListIdentityRecheck(input) {
|
|
3
5
|
let pending;
|
|
4
6
|
const loadRows = input.loadRows;
|
|
5
7
|
return async (request) => {
|
|
8
|
+
const configuredHome = request.options.claudeHome;
|
|
6
9
|
const snapshots = request.session.agent === "claude" && loadRows
|
|
7
10
|
? await (pending ??= observeClaudeListIdentitySnapshots({
|
|
8
11
|
sessions: request.selectedSessions,
|
|
12
|
+
claudeHome: typeof configuredHome === "string" ? expandHome(configuredHome) : undefined,
|
|
9
13
|
loadRows: () => loadRows(request.options, { required: true }),
|
|
10
14
|
observeWindowRole: session => input.observeWindowRole?.(request.options, session.pid, session.cwd ?? session.terminalControl?.currentPath),
|
|
11
15
|
observe: (session, claudeAgentRows) => input.observe({ options: request.options,
|
|
@@ -39,6 +43,11 @@ export async function observeClaudeListIdentitySnapshots(input) {
|
|
|
39
43
|
try {
|
|
40
44
|
const observation = await input.observe(session, rows);
|
|
41
45
|
result.set(session.pid, { observation,
|
|
46
|
+
admission: observeClaudeTerminalAdmission({ pid: session.pid,
|
|
47
|
+
cwd: session.cwd ?? session.terminalControl?.currentPath,
|
|
48
|
+
sessionId: observation.status === "resolved" ? observation.identity.sessionId : undefined,
|
|
49
|
+
processStartedAt: observation.status === "resolved" ? observation.identity.processStartedAt : undefined,
|
|
50
|
+
agentRows: rows, claudeHome: input.claudeHome }),
|
|
42
51
|
...(retry ? { recheck: { attempted: true,
|
|
43
52
|
status: observation.status === "resolved" ? "resolved" : "unresolved"
|
|
44
53
|
} } : {}) });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"terminal-list-native-identity-recheck.js","sourceRoot":"","sources":["../../src/terminal-list-native-identity-recheck.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"terminal-list-native-identity-recheck.js","sourceRoot":"","sources":["../../src/terminal-list-native-identity-recheck.ts"],"names":[],"mappings":"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"}
|
|
@@ -32,8 +32,8 @@ export declare function decideTerminalMonitorApproval(input: TerminalMonitorAppr
|
|
|
32
32
|
markPromptCleared: boolean;
|
|
33
33
|
suppressions: TerminalMonitorApprovalSuppression[];
|
|
34
34
|
notification: {
|
|
35
|
-
kind: string;
|
|
36
35
|
reason?: undefined;
|
|
36
|
+
kind: string;
|
|
37
37
|
};
|
|
38
38
|
} | {
|
|
39
39
|
markPromptCleared: boolean;
|
|
@@ -2,11 +2,11 @@ import type { ExecutorKind } from "./executors.js";
|
|
|
2
2
|
import type { ActiveTerminalProcess, TerminalControlRef } from "./terminal-agent-adapter.js";
|
|
3
3
|
import type { TerminalListTerminalFacts } from "./terminal-list-facts.js";
|
|
4
4
|
export declare function permissionControlCapability(agent: ExecutorKind, version?: string): {
|
|
5
|
-
reason?: undefined;
|
|
6
5
|
status: string;
|
|
7
6
|
agentVersion: string;
|
|
8
7
|
behaviorProfile: string;
|
|
9
8
|
scope: "current_session";
|
|
9
|
+
reason?: undefined;
|
|
10
10
|
} | {
|
|
11
11
|
agentVersion?: undefined;
|
|
12
12
|
behaviorProfile?: undefined;
|
package/docs/list-output.md
CHANGED
|
@@ -44,6 +44,25 @@ Watch, with the exact active input revalidated when observation starts. A
|
|
|
44
44
|
terminal-only Watch can observe terminal activity; it does not establish an
|
|
45
45
|
exact native task or prove that task succeeded.
|
|
46
46
|
|
|
47
|
+
For Claude, an idle screen does not by itself authorize managed Send or New
|
|
48
|
+
thread. Each action offer uses that operation's current reader identity
|
|
49
|
+
and idle checks from execution; managed Send additionally checks that a safe
|
|
50
|
+
transcript boundary can be captured. A missing, busy or mismatched reader row,
|
|
51
|
+
or an unsafe transcript boundary, removes the affected managed action and
|
|
52
|
+
provides a recovery explanation. The independent physical Send action retains
|
|
53
|
+
its own input checks. No managed operation silently falls back to physical
|
|
54
|
+
input. `managed_send_readiness` and `thread_lifecycle_readiness` report the
|
|
55
|
+
affected check and next steps without exposing private transcript anchors.
|
|
56
|
+
Execution obtains fresh evidence again, because state can change after the
|
|
57
|
+
list observation.
|
|
58
|
+
|
|
59
|
+
A resumed Claude thread may retain its UUID while running in a new process.
|
|
60
|
+
New thread can safely reattach an existing Session belonging to a conclusively
|
|
61
|
+
inactive process before starting its transition. This preserves history and
|
|
62
|
+
increments the binding generation; it does not ignore native-thread claims or
|
|
63
|
+
relax Store authority. List remains read-only, and unknown process ownership
|
|
64
|
+
or unresolved work still prevents automatic reattachment.
|
|
65
|
+
|
|
47
66
|
For an unresolved Claude terminal identity, List makes one additional fresh
|
|
48
67
|
reader check, shared across the unresolved Claude terminals in that scan. It
|
|
49
68
|
does not send terminal input or trust a registry file alone. If native identity
|
package/docs/operator-guide.md
CHANGED
|
@@ -97,6 +97,32 @@ terminal Watch can report terminal activity while identity is unresolved; it
|
|
|
97
97
|
cannot promise exact task completion. A count of related managed Sessions is
|
|
98
98
|
history, not proof that this newly discovered conversation is currently bound.
|
|
99
99
|
|
|
100
|
+
Claude can resume the same native thread after its process exits. An unchanged
|
|
101
|
+
thread UUID is expected in that case; the process PID and startup identity must
|
|
102
|
+
still be verified afresh. New thread uses the same safe Session reattachment as
|
|
103
|
+
Send when the prior process is conclusively gone or the same PID has a proven
|
|
104
|
+
new incarnation. AKK preserves the Session history and advances its binding
|
|
105
|
+
generation under the terminal and Store locks, rather than deleting the claim.
|
|
106
|
+
This recovery does not require a manual reconciliation for an otherwise healthy
|
|
107
|
+
Session. Active or unverifiable owners, unfinished Turns or thread transitions,
|
|
108
|
+
and cross-Store authority conflicts still prevent automatic recovery.
|
|
109
|
+
|
|
110
|
+
An idle-looking Claude window alone does not prove managed control is ready.
|
|
111
|
+
List applies each operation's existing reader and idle checks for the current
|
|
112
|
+
process; managed Send also needs a safe transcript boundary
|
|
113
|
+
for acceptance and completion monitoring. When one of these checks fails, List
|
|
114
|
+
explains the missing evidence and does not offer that managed operation. Wait
|
|
115
|
+
for current work to finish and refresh List for reader-state failures; inspect
|
|
116
|
+
Status and the transcript diagnostic for file-access or incomplete-write
|
|
117
|
+
failures. Do not weaken transcript permissions or delete history to force a
|
|
118
|
+
Send. An independently offered physical terminal Send remains a separate,
|
|
119
|
+
explicit choice and cannot promise native task acceptance or completion.
|
|
120
|
+
|
|
121
|
+
List is an observation, not a reservation. Execution repeats the checks before
|
|
122
|
+
input, so a process, thread, file or prompt that changes after listing can still
|
|
123
|
+
cause a refusal. Refresh List after resolving the reported condition; never
|
|
124
|
+
automatically retry a task whose earlier delivery is uncertain.
|
|
125
|
+
|
|
100
126
|
## Command reference
|
|
101
127
|
|
|
102
128
|
Direct slash commands are available in every first-party Host integration:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@scotthuang/agent-knock-knock",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.6",
|
|
4
4
|
"description": "Delegate to existing Codex CLI, Codex Desktop, and Claude Code sessions from OpenClaw or compatible controller Hosts, with native direct control and supported terminal fallbacks.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|