@scotthuang/agent-knock-knock 0.14.2 → 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.
Files changed (116) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +233 -108
  3. package/dist/src/backend-callback-public-projection.d.ts +27 -0
  4. package/dist/src/backend-callback-public-projection.js +58 -0
  5. package/dist/src/backend-callback-public-projection.js.map +1 -0
  6. package/dist/src/backend-public-progress.d.ts +2 -0
  7. package/dist/src/backend-public-progress.js +4 -1
  8. package/dist/src/backend-public-progress.js.map +1 -1
  9. package/dist/src/backend-recovery-semantic.js +5 -4
  10. package/dist/src/backend-recovery-semantic.js.map +1 -1
  11. package/dist/src/callback-transport.d.ts +1 -1
  12. package/dist/src/callback-transport.js +2 -2
  13. package/dist/src/callback-transport.js.map +1 -1
  14. package/dist/src/claude-conversation-routing-cli-adapter.d.ts +2 -0
  15. package/dist/src/claude-conversation-routing-cli-adapter.js +127 -0
  16. package/dist/src/claude-conversation-routing-cli-adapter.js.map +1 -0
  17. package/dist/src/claude-conversation-routing-identity.d.ts +11 -0
  18. package/dist/src/claude-conversation-routing-identity.js +46 -0
  19. package/dist/src/claude-conversation-routing-identity.js.map +1 -0
  20. package/dist/src/claude-native-cli-adapter.d.ts +18 -0
  21. package/dist/src/claude-native-cli-adapter.js +159 -0
  22. package/dist/src/claude-native-cli-adapter.js.map +1 -0
  23. package/dist/src/claude-native-client.d.ts +57 -0
  24. package/dist/src/claude-native-client.js +197 -0
  25. package/dist/src/claude-native-client.js.map +1 -0
  26. package/dist/src/claude-native-discovery.d.ts +20 -0
  27. package/dist/src/claude-native-discovery.js +111 -0
  28. package/dist/src/claude-native-discovery.js.map +1 -0
  29. package/dist/src/claude-native-identity.d.ts +29 -0
  30. package/dist/src/claude-native-identity.js +54 -0
  31. package/dist/src/claude-native-identity.js.map +1 -0
  32. package/dist/src/claude-native-monitor.d.ts +13 -0
  33. package/dist/src/claude-native-monitor.js +123 -0
  34. package/dist/src/claude-native-monitor.js.map +1 -0
  35. package/dist/src/claude-native-observation.d.ts +54 -0
  36. package/dist/src/claude-native-observation.js +418 -0
  37. package/dist/src/claude-native-observation.js.map +1 -0
  38. package/dist/src/claude-native-outbox.d.ts +16 -0
  39. package/dist/src/claude-native-outbox.js +122 -0
  40. package/dist/src/claude-native-outbox.js.map +1 -0
  41. package/dist/src/claude-native-peer-helper.d.ts +2 -0
  42. package/dist/src/claude-native-peer-helper.js +121 -0
  43. package/dist/src/claude-native-peer-helper.js.map +1 -0
  44. package/dist/src/claude-native-public-projection.d.ts +605 -0
  45. package/dist/src/claude-native-public-projection.js +98 -0
  46. package/dist/src/claude-native-public-projection.js.map +1 -0
  47. package/dist/src/claude-native-runtime.d.ts +25 -0
  48. package/dist/src/claude-native-runtime.js +74 -0
  49. package/dist/src/claude-native-runtime.js.map +1 -0
  50. package/dist/src/claude-native-state-store.d.ts +49 -0
  51. package/dist/src/claude-native-state-store.js +96 -0
  52. package/dist/src/claude-native-state-store.js.map +1 -0
  53. package/dist/src/claude-native-task-service.d.ts +70 -0
  54. package/dist/src/claude-native-task-service.js +327 -0
  55. package/dist/src/claude-native-task-service.js.map +1 -0
  56. package/dist/src/cli-core.js +2 -1
  57. package/dist/src/cli-core.js.map +1 -1
  58. package/dist/src/cli-runtime-context.d.ts +2 -0
  59. package/dist/src/cli-runtime-context.js.map +1 -1
  60. package/dist/src/codex-native-outbox.js +7 -5
  61. package/dist/src/codex-native-outbox.js.map +1 -1
  62. package/dist/src/codex-native-public-projection.d.ts +17 -7
  63. package/dist/src/codex-native-public-projection.js +4 -4
  64. package/dist/src/codex-native-public-projection.js.map +1 -1
  65. package/dist/src/codex-native-semantic.js +15 -5
  66. package/dist/src/codex-native-semantic.js.map +1 -1
  67. package/dist/src/conversation-list.js +8 -2
  68. package/dist/src/conversation-list.js.map +1 -1
  69. package/dist/src/conversation-routing-cli-adapter.d.ts +2 -7
  70. package/dist/src/conversation-routing-cli-adapter.js +4 -2
  71. package/dist/src/conversation-routing-cli-adapter.js.map +1 -1
  72. package/dist/src/conversation-routing-commands.d.ts +5 -0
  73. package/dist/src/conversation-routing-commands.js.map +1 -1
  74. package/dist/src/desktop-command-presentation.js +3 -1
  75. package/dist/src/desktop-command-presentation.js.map +1 -1
  76. package/dist/src/desktop-public-projection.js +3 -6
  77. package/dist/src/desktop-public-projection.js.map +1 -1
  78. package/dist/src/desktop-task-service.js +10 -3
  79. package/dist/src/desktop-task-service.js.map +1 -1
  80. package/dist/src/durable-notification-kernel.d.ts +10 -0
  81. package/dist/src/durable-notification-kernel.js +18 -1
  82. package/dist/src/durable-notification-kernel.js.map +1 -1
  83. package/dist/src/host-monitor-reconciliation.js +9 -1
  84. package/dist/src/host-monitor-reconciliation.js.map +1 -1
  85. package/dist/src/host-profile-runtime.js +3 -1
  86. package/dist/src/host-profile-runtime.js.map +1 -1
  87. package/dist/src/local-codex-cli-adapter.js +4 -3
  88. package/dist/src/local-codex-cli-adapter.js.map +1 -1
  89. package/dist/src/openclaw-callback-evidence.d.ts +17 -0
  90. package/dist/src/openclaw-callback-evidence.js +75 -0
  91. package/dist/src/openclaw-callback-evidence.js.map +1 -0
  92. package/dist/src/openclaw-callback-transport.js +90 -9
  93. package/dist/src/openclaw-callback-transport.js.map +1 -1
  94. package/dist/src/semantic-conversation-target.js +1 -1
  95. package/dist/src/semantic-conversation-target.js.map +1 -1
  96. package/dist/src/semantic-tool-command-helpers.d.ts +0 -1
  97. package/dist/src/semantic-tool-command-helpers.js +27 -17
  98. package/dist/src/semantic-tool-command-helpers.js.map +1 -1
  99. package/dist/src/semantic-tool-descriptions.js +3 -3
  100. package/dist/src/semantic-tool-descriptions.js.map +1 -1
  101. package/dist/src/semantic-tool-list-projection.js +11 -4
  102. package/dist/src/semantic-tool-list-projection.js.map +1 -1
  103. package/dist/src/semantic-tool-presentation.js +17 -3
  104. package/dist/src/semantic-tool-presentation.js.map +1 -1
  105. package/dist/src/semantic-tool-runtime.js +8 -1
  106. package/dist/src/semantic-tool-runtime.js.map +1 -1
  107. package/dist/src/semantic-tool-schemas.js +15 -15
  108. package/dist/src/semantic-tool-schemas.js.map +1 -1
  109. package/dist/src/terminal-list-cli-adapter.js +5 -1
  110. package/dist/src/terminal-list-cli-adapter.js.map +1 -1
  111. package/dist/src/terminal-list-ownership-service.js +1 -1
  112. package/dist/src/terminal-list-ownership-service.js.map +1 -1
  113. package/docs/backend-task-recovery.md +43 -0
  114. package/docs/claude-cli-direct.md +60 -0
  115. package/package.json +2 -2
  116. package/templates/openclaw-skills/agent-knock-knock/SKILL.md +14 -4
@@ -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,2 @@
1
+ /** AKK-side macOS peer credential bridge. Never installed into or registered as Claude. */
2
+ export declare const CLAUDE_NATIVE_PEER_HELPER: string;
@@ -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"}