@scotthuang/agent-knock-knock 0.14.1 → 0.14.3
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 +29 -0
- package/README.md +233 -106
- package/dist/src/backend-callback-public-projection.d.ts +27 -0
- package/dist/src/backend-callback-public-projection.js +58 -0
- package/dist/src/backend-callback-public-projection.js.map +1 -0
- package/dist/src/backend-public-progress.d.ts +2 -0
- package/dist/src/backend-public-progress.js +4 -1
- package/dist/src/backend-public-progress.js.map +1 -1
- package/dist/src/backend-recovery-semantic.js +5 -4
- package/dist/src/backend-recovery-semantic.js.map +1 -1
- package/dist/src/callback-transport.d.ts +1 -1
- package/dist/src/callback-transport.js +2 -2
- package/dist/src/callback-transport.js.map +1 -1
- package/dist/src/claude-conversation-routing-cli-adapter.d.ts +2 -0
- package/dist/src/claude-conversation-routing-cli-adapter.js +127 -0
- package/dist/src/claude-conversation-routing-cli-adapter.js.map +1 -0
- package/dist/src/claude-conversation-routing-identity.d.ts +11 -0
- package/dist/src/claude-conversation-routing-identity.js +46 -0
- package/dist/src/claude-conversation-routing-identity.js.map +1 -0
- package/dist/src/claude-native-cli-adapter.d.ts +18 -0
- package/dist/src/claude-native-cli-adapter.js +159 -0
- package/dist/src/claude-native-cli-adapter.js.map +1 -0
- package/dist/src/claude-native-client.d.ts +57 -0
- package/dist/src/claude-native-client.js +197 -0
- package/dist/src/claude-native-client.js.map +1 -0
- package/dist/src/claude-native-discovery.d.ts +20 -0
- package/dist/src/claude-native-discovery.js +111 -0
- package/dist/src/claude-native-discovery.js.map +1 -0
- package/dist/src/claude-native-identity.d.ts +29 -0
- package/dist/src/claude-native-identity.js +54 -0
- package/dist/src/claude-native-identity.js.map +1 -0
- package/dist/src/claude-native-monitor.d.ts +13 -0
- package/dist/src/claude-native-monitor.js +123 -0
- package/dist/src/claude-native-monitor.js.map +1 -0
- package/dist/src/claude-native-observation.d.ts +54 -0
- package/dist/src/claude-native-observation.js +418 -0
- package/dist/src/claude-native-observation.js.map +1 -0
- package/dist/src/claude-native-outbox.d.ts +16 -0
- package/dist/src/claude-native-outbox.js +122 -0
- package/dist/src/claude-native-outbox.js.map +1 -0
- package/dist/src/claude-native-peer-helper.d.ts +2 -0
- package/dist/src/claude-native-peer-helper.js +121 -0
- package/dist/src/claude-native-peer-helper.js.map +1 -0
- package/dist/src/claude-native-public-projection.d.ts +605 -0
- package/dist/src/claude-native-public-projection.js +98 -0
- package/dist/src/claude-native-public-projection.js.map +1 -0
- package/dist/src/claude-native-runtime.d.ts +25 -0
- package/dist/src/claude-native-runtime.js +74 -0
- package/dist/src/claude-native-runtime.js.map +1 -0
- package/dist/src/claude-native-state-store.d.ts +49 -0
- package/dist/src/claude-native-state-store.js +96 -0
- package/dist/src/claude-native-state-store.js.map +1 -0
- package/dist/src/claude-native-task-service.d.ts +70 -0
- package/dist/src/claude-native-task-service.js +327 -0
- package/dist/src/claude-native-task-service.js.map +1 -0
- package/dist/src/cli-core.js +2 -1
- package/dist/src/cli-core.js.map +1 -1
- package/dist/src/cli-runtime-context.d.ts +2 -0
- package/dist/src/cli-runtime-context.js.map +1 -1
- package/dist/src/codex-async-question-adapter.js +18 -9
- package/dist/src/codex-async-question-adapter.js.map +1 -1
- package/dist/src/codex-lifecycle-compatibility.d.ts +1 -1
- package/dist/src/codex-lifecycle-compatibility.js +5 -3
- package/dist/src/codex-lifecycle-compatibility.js.map +1 -1
- package/dist/src/codex-native-cli-adapter.js +18 -2
- package/dist/src/codex-native-cli-adapter.js.map +1 -1
- package/dist/src/codex-native-client-rpc.js +5 -1
- package/dist/src/codex-native-client-rpc.js.map +1 -1
- package/dist/src/codex-native-client.js +8 -7
- package/dist/src/codex-native-client.js.map +1 -1
- package/dist/src/codex-native-outbox.js +7 -5
- package/dist/src/codex-native-outbox.js.map +1 -1
- package/dist/src/codex-native-public-projection.d.ts +19 -7
- package/dist/src/codex-native-public-projection.js +12 -8
- package/dist/src/codex-native-public-projection.js.map +1 -1
- package/dist/src/codex-native-semantic.js +15 -5
- package/dist/src/codex-native-semantic.js.map +1 -1
- package/dist/src/codex-native-types.d.ts +4 -2
- package/dist/src/codex-native-types.js.map +1 -1
- package/dist/src/codex-permission-surface.d.ts +2 -2
- package/dist/src/codex-permission-surface.js +62 -4
- package/dist/src/codex-permission-surface.js.map +1 -1
- package/dist/src/codex-status-history-navigation.js +2 -6
- package/dist/src/codex-status-history-navigation.js.map +1 -1
- package/dist/src/codex-terminal-agent-adapter.d.ts +1 -0
- package/dist/src/codex-terminal-agent-adapter.js +10 -5
- package/dist/src/codex-terminal-agent-adapter.js.map +1 -1
- package/dist/src/conversation-list.js +8 -2
- package/dist/src/conversation-list.js.map +1 -1
- package/dist/src/conversation-routing-cli-adapter.d.ts +2 -7
- package/dist/src/conversation-routing-cli-adapter.js +4 -2
- package/dist/src/conversation-routing-cli-adapter.js.map +1 -1
- package/dist/src/conversation-routing-commands.d.ts +5 -0
- package/dist/src/conversation-routing-commands.js.map +1 -1
- package/dist/src/desktop-command-presentation.js +3 -1
- package/dist/src/desktop-command-presentation.js.map +1 -1
- package/dist/src/desktop-public-projection.js +3 -6
- package/dist/src/desktop-public-projection.js.map +1 -1
- package/dist/src/desktop-task-service.js +10 -3
- package/dist/src/desktop-task-service.js.map +1 -1
- package/dist/src/durable-notification-kernel.d.ts +10 -0
- package/dist/src/durable-notification-kernel.js +18 -1
- package/dist/src/durable-notification-kernel.js.map +1 -1
- package/dist/src/host-monitor-reconciliation.js +9 -1
- package/dist/src/host-monitor-reconciliation.js.map +1 -1
- package/dist/src/host-profile-runtime.js +3 -1
- package/dist/src/host-profile-runtime.js.map +1 -1
- package/dist/src/local-codex-cli-adapter.js +4 -3
- package/dist/src/local-codex-cli-adapter.js.map +1 -1
- package/dist/src/openclaw-callback-evidence.d.ts +17 -0
- package/dist/src/openclaw-callback-evidence.js +75 -0
- package/dist/src/openclaw-callback-evidence.js.map +1 -0
- package/dist/src/openclaw-callback-transport.js +90 -9
- package/dist/src/openclaw-callback-transport.js.map +1 -1
- package/dist/src/semantic-conversation-target.js +1 -1
- package/dist/src/semantic-conversation-target.js.map +1 -1
- package/dist/src/semantic-tool-command-helpers.d.ts +0 -1
- package/dist/src/semantic-tool-command-helpers.js +27 -17
- package/dist/src/semantic-tool-command-helpers.js.map +1 -1
- package/dist/src/semantic-tool-descriptions.js +3 -3
- package/dist/src/semantic-tool-descriptions.js.map +1 -1
- package/dist/src/semantic-tool-list-projection.js +11 -4
- package/dist/src/semantic-tool-list-projection.js.map +1 -1
- package/dist/src/semantic-tool-presentation.js +17 -3
- package/dist/src/semantic-tool-presentation.js.map +1 -1
- package/dist/src/semantic-tool-runtime.js +30 -3
- package/dist/src/semantic-tool-runtime.js.map +1 -1
- package/dist/src/semantic-tool-schemas.js +15 -15
- package/dist/src/semantic-tool-schemas.js.map +1 -1
- package/dist/src/terminal-list-cli-adapter.js +5 -1
- package/dist/src/terminal-list-cli-adapter.js.map +1 -1
- package/dist/src/terminal-list-ownership-service.js +1 -1
- package/dist/src/terminal-list-ownership-service.js.map +1 -1
- package/dist/src/terminal-model-control-profile.d.ts +2 -1
- package/dist/src/terminal-model-control-profile.js +5 -2
- package/dist/src/terminal-model-control-profile.js.map +1 -1
- package/dist/src/terminal-native-inspection-profile.js +2 -0
- package/dist/src/terminal-native-inspection-profile.js.map +1 -1
- package/dist/src/terminal-permission-control-bridge.js +1 -1
- package/dist/src/terminal-permission-control-bridge.js.map +1 -1
- package/dist/src/terminal-permission-control.js +1 -1
- package/dist/src/terminal-permission-control.js.map +1 -1
- package/dist/src/terminal-questionnaire-adapter.js +10 -5
- package/dist/src/terminal-questionnaire-adapter.js.map +1 -1
- package/docs/backend-task-recovery.md +43 -0
- package/docs/claude-cli-direct.md +60 -0
- package/docs/codex-0.162.1-compatibility.md +198 -0
- package/docs/codex-cli-native-compatibility.md +9 -6
- package/package.json +2 -2
- package/templates/openclaw-skills/agent-knock-knock/SKILL.md +16 -6
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { backendCallbackMaxAttempts, backendObservationStopped } from "./backend-task-recovery.js";
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
import { parseCallbackAttemptOutcome } from "./callback-transport.js";
|
|
4
|
+
import { canSettleExpiredNotificationAttempt, createDurableNotificationLease, decideDurableNotificationRetry, reduceDurableNotificationSettlement } from "./durable-notification-kernel.js";
|
|
5
|
+
/** Lease and durable checkpoint semantics are shared with the other AKK transports. */
|
|
6
|
+
export function createClaudeNativeNotificationOutbox(deps) {
|
|
7
|
+
const now = deps.now ?? (() => new Date());
|
|
8
|
+
const uuid = deps.randomUUID ?? randomUUID;
|
|
9
|
+
const maxAttempts = deps.maxDeliveryAttempts ?? 4;
|
|
10
|
+
function update(id, operation) {
|
|
11
|
+
return deps.repository.withLock(id, () => {
|
|
12
|
+
const task = deps.repository.load(id);
|
|
13
|
+
if (!task)
|
|
14
|
+
throw new Error("Claude native Watch not found");
|
|
15
|
+
operation(task);
|
|
16
|
+
task.updated_at = now().toISOString();
|
|
17
|
+
return deps.repository.save(task, task.revision);
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
function stale(task, note) {
|
|
21
|
+
if (note.envelope.event.type === "claude_native_watch.timed_out") {
|
|
22
|
+
const expected = `${task.id}:timed_out${task.renewal_count ? `:${task.renewal_count}` : ""}`;
|
|
23
|
+
if (task.status !== "timed_out" || note.id !== expected)
|
|
24
|
+
return true;
|
|
25
|
+
}
|
|
26
|
+
const interactionId = note.envelope.event.metadata?.interaction_id;
|
|
27
|
+
return typeof interactionId === "string"; // This route never publishes actionable native interactions.
|
|
28
|
+
}
|
|
29
|
+
function settle(id, notificationId, attemptId, outcome) {
|
|
30
|
+
update(id, task => {
|
|
31
|
+
const n = task.notifications.find(candidate => candidate.id === notificationId);
|
|
32
|
+
if (!n || n.attempt_id !== attemptId)
|
|
33
|
+
return;
|
|
34
|
+
const definitiveLateOutcome = canSettleExpiredNotificationAttempt({ status: n.status, previousOutcome: n.outcome,
|
|
35
|
+
leaseExpiredCode: "claude_native_callback_lease_expired", outcome, attemptId,
|
|
36
|
+
deliveryId: n.envelope.delivery_id, idempotencyKey: n.envelope.idempotency_key });
|
|
37
|
+
if (n.status !== "leased" && !definitiveLateOutcome)
|
|
38
|
+
return;
|
|
39
|
+
if (outcome.disposition === "retryable_failure" && stale(task, n)) {
|
|
40
|
+
n.status = "failed";
|
|
41
|
+
n.outcome = { disposition: "permanent_failure", error_code: "claude_native_callback_stale" };
|
|
42
|
+
delete n.retry_at;
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
delete n.retry_at;
|
|
46
|
+
const result = reduceDurableNotificationSettlement({ attempt: n.attempts, outcome, retryEnabled: !backendObservationStopped(task) && !stale(task, n),
|
|
47
|
+
maxRetryAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1 });
|
|
48
|
+
n.outcome = result.outcome;
|
|
49
|
+
if (result.state === "accepted")
|
|
50
|
+
n.status = "accepted";
|
|
51
|
+
else if (result.state === "failed" && result.retryAuthorized) {
|
|
52
|
+
n.status = "retry_wait";
|
|
53
|
+
n.retry_at = new Date(now().getTime() + (deps.retryDelayMs ?? 5000) * 2 ** (n.attempts - 1)).toISOString();
|
|
54
|
+
}
|
|
55
|
+
else
|
|
56
|
+
n.status = outcome.disposition === "uncertain" ? "uncertain" : "failed";
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
return {
|
|
60
|
+
async deliverPending(id, notificationId) {
|
|
61
|
+
let claimed;
|
|
62
|
+
update(id, task => {
|
|
63
|
+
for (const n of task.notifications) {
|
|
64
|
+
if (notificationId && n.id !== notificationId)
|
|
65
|
+
continue;
|
|
66
|
+
if (n.status === "leased" && Date.parse(n.lease_expires_at) <= now().getTime()) {
|
|
67
|
+
n.status = "uncertain";
|
|
68
|
+
n.outcome = { disposition: "uncertain", error_code: "claude_native_callback_lease_expired", observed_at: now().toISOString() };
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
if (backendObservationStopped(task) || !deps.deliver)
|
|
72
|
+
continue;
|
|
73
|
+
if (["ready", "retry_wait"].includes(n.status) && stale(task, n)) {
|
|
74
|
+
n.status = "failed";
|
|
75
|
+
n.outcome = { disposition: "permanent_failure", error_code: "claude_native_callback_stale" };
|
|
76
|
+
delete n.retry_at;
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
const decision = decideDurableNotificationRetry(n.status === "ready"
|
|
80
|
+
? { phase: "ready", attempt: n.attempts, maxAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1 }
|
|
81
|
+
: n.status === "retry_wait"
|
|
82
|
+
? { phase: "retry_wait", attempt: n.attempts, maxAttempts: backendCallbackMaxAttempts(n, maxAttempts) - 1, nowMs: now().getTime(), retryAt: n.retry_at, retryAuthorized: true }
|
|
83
|
+
: { phase: "settled", attempt: n.attempts });
|
|
84
|
+
if (decision.state !== "retryable")
|
|
85
|
+
continue;
|
|
86
|
+
const lease = createDurableNotificationLease({ previousAttempts: n.attempts, attemptId: uuid(), attemptedAt: now().toISOString(),
|
|
87
|
+
leaseBaseMs: now().getTime(), leaseMs: deps.deliveryLeaseMs ?? 30_000 });
|
|
88
|
+
n.status = "leased";
|
|
89
|
+
n.attempts = lease.attempt;
|
|
90
|
+
n.attempt_id = lease.attemptId;
|
|
91
|
+
n.lease_expires_at = lease.leaseExpiresAt;
|
|
92
|
+
claimed = { task: structuredClone(task), notification: structuredClone(n) };
|
|
93
|
+
break;
|
|
94
|
+
}
|
|
95
|
+
});
|
|
96
|
+
if (!claimed)
|
|
97
|
+
return;
|
|
98
|
+
const { task, notification: n } = claimed;
|
|
99
|
+
let outcome;
|
|
100
|
+
try {
|
|
101
|
+
const context = deps.resolveCallbackContext?.(task);
|
|
102
|
+
const current = deps.repository.load(id);
|
|
103
|
+
if (!current || backendObservationStopped(current) || stale(current, n)) {
|
|
104
|
+
settle(id, n.id, n.attempt_id, { disposition: "permanent_failure", error_code: "claude_native_callback_stopped" });
|
|
105
|
+
return;
|
|
106
|
+
}
|
|
107
|
+
outcome = parseCallbackAttemptOutcome(await deps.deliver({ route: task.callback_route, envelope: n.envelope,
|
|
108
|
+
attempt: { number: n.attempts, id: n.attempt_id }, context,
|
|
109
|
+
reportCheckpoint: checkpoint => {
|
|
110
|
+
const parsed = parseCallbackAttemptOutcome(checkpoint);
|
|
111
|
+
if (parsed.disposition === "accepted")
|
|
112
|
+
settle(id, n.id, n.attempt_id, parsed);
|
|
113
|
+
} }));
|
|
114
|
+
}
|
|
115
|
+
catch {
|
|
116
|
+
outcome = { disposition: "uncertain", error_code: "claude_native_callback_outcome_unknown", observed_at: now().toISOString() };
|
|
117
|
+
}
|
|
118
|
+
settle(id, n.id, n.attempt_id, outcome);
|
|
119
|
+
}
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=claude-native-outbox.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"claude-native-outbox.js","sourceRoot":"","sources":["../../src/claude-native-outbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
/** AKK-side macOS peer credential bridge. Never installed into or registered as Claude. */
|
|
2
|
+
export const CLAUDE_NATIVE_PEER_HELPER = String.raw `
|
|
3
|
+
import sys,os,json,socket,struct,stat,subprocess,time,select,uuid,signal
|
|
4
|
+
listeners={}
|
|
5
|
+
def stop(signum,frame):raise SystemExit(0)
|
|
6
|
+
signal.signal(signal.SIGTERM,stop)
|
|
7
|
+
def emit(value):
|
|
8
|
+
print(json.dumps(value,separators=(',',':')),flush=True)
|
|
9
|
+
def owned(p,kind):
|
|
10
|
+
s=os.lstat(p)
|
|
11
|
+
valid=stat.S_ISREG(s.st_mode) if kind=='file' else stat.S_ISSOCK(s.st_mode) if kind=='socket' else stat.S_ISDIR(s.st_mode)
|
|
12
|
+
if s.st_uid!=os.getuid() or s.st_mode & 0o022 or not valid: raise ValueError('unsafe_metadata')
|
|
13
|
+
return s
|
|
14
|
+
def validate(e,idle=False):
|
|
15
|
+
p=os.path.join(e['configDir'],'sessions',str(e['pid'])+'.json')
|
|
16
|
+
owned(e['configDir'],'directory');owned(os.path.dirname(p),'directory')
|
|
17
|
+
if owned(p,'file').st_size>65536: raise ValueError('invalid_registry')
|
|
18
|
+
with open(p) as f:m=json.load(f)
|
|
19
|
+
start=' '.join(str(m.get('procStart','')).split())
|
|
20
|
+
if m.get('pid')!=e['pid'] or m.get('sessionId')!=e['sessionId'] or start!=e['processStart']:raise ValueError('identity_changed')
|
|
21
|
+
if m.get('messagingSocketPath')!=e['socketPath'] or m.get('peerProtocol')!=1:raise ValueError('unsupported_contract')
|
|
22
|
+
value=subprocess.check_output(['/bin/ps','-p',str(e['pid']),'-o','uid=','-o','lstart='],timeout=2,text=True,env={**os.environ,'LC_ALL':'C','TZ':'UTC'})
|
|
23
|
+
if ' '.join(value.split())!=str(os.getuid())+' '+e['processStart']:raise ValueError('process_changed')
|
|
24
|
+
if idle and m.get('status')!='idle':raise ValueError('session_not_idle')
|
|
25
|
+
owned(os.path.realpath(os.path.dirname(e['socketPath'])),'directory');owned(e['socketPath'],'socket')
|
|
26
|
+
def peer(c,pid):
|
|
27
|
+
actual=struct.unpack('i',c.getsockopt(0,2,4))[0]
|
|
28
|
+
cred=c.getsockopt(0,1,80)
|
|
29
|
+
version,uid=struct.unpack_from('II',cred)
|
|
30
|
+
if actual!=pid or version!=0 or uid!=os.getuid():raise ValueError('peer_identity_mismatch')
|
|
31
|
+
def reply(e):
|
|
32
|
+
key=e['socketPath']+'|'+e['sessionId']+'|'+e['processStart']
|
|
33
|
+
if key in listeners:return listeners[key]
|
|
34
|
+
# A small fixed bound prevents a long-lived host from leaking sockets indefinitely.
|
|
35
|
+
if len(listeners)>=32:raise ValueError('listener_limit')
|
|
36
|
+
p=os.path.join(os.path.dirname(e['socketPath']),str(os.getpid())+'-'+uuid.uuid4().hex[:8]+'.sock')
|
|
37
|
+
s=socket.socket(socket.AF_UNIX);created=False
|
|
38
|
+
try:
|
|
39
|
+
s.bind(p);created=True;os.chmod(p,0o600);s.listen(8);s.setblocking(False)
|
|
40
|
+
except BaseException:
|
|
41
|
+
s.close()
|
|
42
|
+
if created:
|
|
43
|
+
try:os.unlink(p)
|
|
44
|
+
except OSError:pass
|
|
45
|
+
raise
|
|
46
|
+
value=(s,p,e);listeners[key]=value;return value
|
|
47
|
+
def receive(ready):
|
|
48
|
+
messages=[]
|
|
49
|
+
for listener in ready:
|
|
50
|
+
entry=next((v for v in listeners.values() if v[0]==listener),None)
|
|
51
|
+
if not entry:continue
|
|
52
|
+
c=None
|
|
53
|
+
try:
|
|
54
|
+
c,_=listener.accept();c.settimeout(.2);peer(c,entry[2]['pid']);validate(entry[2]);buf=b''
|
|
55
|
+
while len(buf)<=65536:
|
|
56
|
+
part=c.recv(8192)
|
|
57
|
+
if not part:break
|
|
58
|
+
buf+=part
|
|
59
|
+
if b'\n' in buf:break
|
|
60
|
+
for line in buf.splitlines():
|
|
61
|
+
m=json.loads(line)
|
|
62
|
+
if m.get('type')!='control' or m.get('action') not in ['peer_message_status','peer_idle_notice']:continue
|
|
63
|
+
if not isinstance(m.get('orig_msg_id'),str):continue
|
|
64
|
+
# Do not relay arbitrary native detail, transcript content or prompt material.
|
|
65
|
+
clean={k:m[k] for k in ['action','orig_msg_id','status','status_detail','state','finished_at'] if k in m and isinstance(m[k],(str,int,float,bool))}
|
|
66
|
+
messages.append(clean);emit({'event':'notice','sessionId':entry[2]['sessionId'],'pid':entry[2]['pid'],'notice':clean})
|
|
67
|
+
except Exception:pass
|
|
68
|
+
finally:
|
|
69
|
+
if c:c.close()
|
|
70
|
+
return messages
|
|
71
|
+
def operation(q):
|
|
72
|
+
e=q['entry'];validate(e,q['action']=='send');c=socket.socket(socket.AF_UNIX);c.settimeout(2);written=False
|
|
73
|
+
try:
|
|
74
|
+
c.connect(e['socketPath']);peer(c,e['pid']);validate(e,q['action']=='send')
|
|
75
|
+
if q['action']=='probe':return {'dispatchState':'not_sent','peerPid':e['pid']}
|
|
76
|
+
ls,p,_=reply(e)
|
|
77
|
+
frame={'type':'user','session_id':e['sessionId'],'uuid':q['inputUuid'],'msgV':1,'msg_id':q['messageId'],'priority':'next','from':'uds:'+p,'message':{'role':'user','content':q['text']}}
|
|
78
|
+
data=(json.dumps(frame,separators=(',',':'))+'\n').encode()
|
|
79
|
+
# Persist-before-dispatch is performed in the parent; any sendall failure is uncertain.
|
|
80
|
+
written=True;c.sendall(data)
|
|
81
|
+
until=time.monotonic()+.4;messages=[]
|
|
82
|
+
while time.monotonic()<until:
|
|
83
|
+
ready,_,_=select.select([x[0] for x in listeners.values()],[],[],max(0,until-time.monotonic()))
|
|
84
|
+
messages+=receive(ready)
|
|
85
|
+
result={'dispatchState':'written'}
|
|
86
|
+
for m in messages:
|
|
87
|
+
if m.get('orig_msg_id')==q['messageId']:
|
|
88
|
+
status='refused' if m.get('status_detail')=='refused' else m.get('status')
|
|
89
|
+
if status in ['held','delivered','refused','expired']:result['deliveryStatus']=status
|
|
90
|
+
return result
|
|
91
|
+
except Exception as exc:
|
|
92
|
+
code=str(exc) if isinstance(exc,ValueError) else 'peer_transport_error'
|
|
93
|
+
return {'dispatchState':'uncertain' if written else 'not_sent','errorCode':code}
|
|
94
|
+
finally:c.close()
|
|
95
|
+
try:
|
|
96
|
+
emit({'ready':True,'pid':os.getpid()})
|
|
97
|
+
incoming=b''
|
|
98
|
+
while True:
|
|
99
|
+
ready,_,_=select.select([sys.stdin]+[x[0] for x in listeners.values()],[],[],1)
|
|
100
|
+
receive([x for x in ready if x is not sys.stdin])
|
|
101
|
+
if sys.stdin not in ready:continue
|
|
102
|
+
part=os.read(sys.stdin.fileno(),65536)
|
|
103
|
+
if not part:break
|
|
104
|
+
incoming+=part
|
|
105
|
+
if len(incoming)>2097152:break
|
|
106
|
+
while b'\n' in incoming:
|
|
107
|
+
line,incoming=incoming.split(b'\n',1);q={}
|
|
108
|
+
try:
|
|
109
|
+
q=json.loads(line)
|
|
110
|
+
if q.get('action')=='close':raise SystemExit(0)
|
|
111
|
+
if q.get('action') not in ['probe','send']:raise ValueError('invalid_action')
|
|
112
|
+
emit({'id':q['id'],'result':operation(q)})
|
|
113
|
+
except Exception as exc:emit({'id':q.get('id'),'result':{'dispatchState':'not_sent','errorCode':str(exc) if isinstance(exc,ValueError) else 'peer_transport_error'}})
|
|
114
|
+
finally:
|
|
115
|
+
for s,p,_ in listeners.values():
|
|
116
|
+
s.close()
|
|
117
|
+
try:
|
|
118
|
+
if stat.S_ISSOCK(os.lstat(p).st_mode) and os.lstat(p).st_uid==os.getuid():os.unlink(p)
|
|
119
|
+
except OSError:pass
|
|
120
|
+
`;
|
|
121
|
+
//# sourceMappingURL=claude-native-peer-helper.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"claude-native-peer-helper.js","sourceRoot":"","sources":["../../src/claude-native-peer-helper.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsHlD,CAAC"}
|