@scotthuang/agent-knock-knock 0.12.11 → 0.12.13
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 +40 -0
- package/README.md +43 -30
- package/dist/src/approval-policy.d.ts +11 -2
- package/dist/src/approval-policy.js +33 -7
- package/dist/src/approval-policy.js.map +1 -1
- package/dist/src/callback-cli-adapter.d.ts +47 -0
- package/dist/src/callback-cli-adapter.js +156 -0
- package/dist/src/callback-cli-adapter.js.map +1 -0
- package/dist/src/callback-outbox-policy.d.ts +95 -0
- package/dist/src/callback-outbox-policy.js +149 -0
- package/dist/src/callback-outbox-policy.js.map +1 -0
- package/dist/src/callback-outbox-service.d.ts +247 -0
- package/dist/src/callback-outbox-service.js +1053 -0
- package/dist/src/callback-outbox-service.js.map +1 -0
- package/dist/src/callback-outbox-settlement.d.ts +54 -0
- package/dist/src/callback-outbox-settlement.js +241 -0
- package/dist/src/callback-outbox-settlement.js.map +1 -0
- package/dist/src/canonical-json.d.ts +1 -0
- package/dist/src/canonical-json.js +14 -0
- package/dist/src/canonical-json.js.map +1 -0
- package/dist/src/claude-lifecycle-compatibility.js +15 -0
- package/dist/src/claude-lifecycle-compatibility.js.map +1 -1
- package/dist/src/claude-local-transcript-provider.d.ts +82 -1
- package/dist/src/claude-local-transcript-provider.js +873 -23
- package/dist/src/claude-local-transcript-provider.js.map +1 -1
- package/dist/src/cli-command-runtime.d.ts +14 -0
- package/dist/src/cli-command-runtime.js +164 -0
- package/dist/src/cli-command-runtime.js.map +1 -0
- package/dist/src/cli-core.d.ts +4 -42
- package/dist/src/cli-core.js +958 -28684
- package/dist/src/cli-core.js.map +1 -1
- package/dist/src/cli-runtime-context.d.ts +57 -0
- package/dist/src/cli-runtime-context.js +118 -0
- package/dist/src/cli-runtime-context.js.map +1 -0
- package/dist/src/codex-lifecycle-compatibility.js +2 -1
- package/dist/src/codex-lifecycle-compatibility.js.map +1 -1
- package/dist/src/codex-local-session-provider.d.ts +18 -0
- package/dist/src/codex-local-session-provider.js +67 -0
- package/dist/src/codex-local-session-provider.js.map +1 -1
- package/dist/src/codex-session-provider.js +1 -3
- package/dist/src/codex-session-provider.js.map +1 -1
- package/dist/src/conversation-trace.d.ts +30 -0
- package/dist/src/conversation-trace.js +185 -0
- package/dist/src/conversation-trace.js.map +1 -0
- package/dist/src/deferred-foreground-application-service.d.ts +84 -0
- package/dist/src/deferred-foreground-application-service.js +742 -0
- package/dist/src/deferred-foreground-application-service.js.map +1 -0
- package/dist/src/deferred-foreground-authority-cli-adapter.d.ts +78 -0
- package/dist/src/deferred-foreground-authority-cli-adapter.js +795 -0
- package/dist/src/deferred-foreground-authority-cli-adapter.js.map +1 -0
- package/dist/src/deferred-foreground-boundary.d.ts +61 -0
- package/dist/src/deferred-foreground-boundary.js +2 -0
- package/dist/src/deferred-foreground-boundary.js.map +1 -0
- package/dist/src/deferred-foreground-capability.d.ts +4 -0
- package/dist/src/deferred-foreground-capability.js +184 -0
- package/dist/src/deferred-foreground-capability.js.map +1 -0
- package/dist/src/deferred-foreground-preparation-cli-adapter.d.ts +53 -0
- package/dist/src/deferred-foreground-preparation-cli-adapter.js +210 -0
- package/dist/src/deferred-foreground-preparation-cli-adapter.js.map +1 -0
- package/dist/src/deferred-foreground-preparation-service.d.ts +72 -0
- package/dist/src/deferred-foreground-preparation-service.js +179 -0
- package/dist/src/deferred-foreground-preparation-service.js.map +1 -0
- package/dist/src/deferred-foreground-recovery-cli-adapter.d.ts +139 -0
- package/dist/src/deferred-foreground-recovery-cli-adapter.js +1125 -0
- package/dist/src/deferred-foreground-recovery-cli-adapter.js.map +1 -0
- package/dist/src/deferred-foreground-recovery-service.d.ts +48 -0
- package/dist/src/deferred-foreground-recovery-service.js +91 -0
- package/dist/src/deferred-foreground-recovery-service.js.map +1 -0
- package/dist/src/deferred-foreground-transfer-policy.d.ts +2 -0
- package/dist/src/deferred-foreground-transfer-policy.js +10 -0
- package/dist/src/deferred-foreground-transfer-policy.js.map +1 -0
- package/dist/src/deferred-foreground-transfer.js +46 -105
- package/dist/src/deferred-foreground-transfer.js.map +1 -1
- package/dist/src/doctor-capabilities.d.ts +9 -0
- package/dist/src/doctor-capabilities.js +22 -0
- package/dist/src/doctor-capabilities.js.map +1 -1
- package/dist/src/durable-json-file.d.ts +22 -0
- package/dist/src/durable-json-file.js +127 -0
- package/dist/src/durable-json-file.js.map +1 -0
- package/dist/src/file-lock-cli-adapter.d.ts +43 -0
- package/dist/src/file-lock-cli-adapter.js +150 -0
- package/dist/src/file-lock-cli-adapter.js.map +1 -0
- package/dist/src/herdr-terminal-control-provider.js +1 -3
- package/dist/src/herdr-terminal-control-provider.js.map +1 -1
- package/dist/src/install-doctor-command-adapter.d.ts +17 -0
- package/dist/src/install-doctor-command-adapter.js +225 -0
- package/dist/src/install-doctor-command-adapter.js.map +1 -0
- package/dist/src/live-lifecycle-evidence.js +76 -46
- package/dist/src/live-lifecycle-evidence.js.map +1 -1
- package/dist/src/live-lifecycle-smoke.js +74 -50
- package/dist/src/live-lifecycle-smoke.js.map +1 -1
- package/dist/src/managed-session.d.ts +2 -0
- package/dist/src/managed-session.js +24 -0
- package/dist/src/managed-session.js.map +1 -1
- package/dist/src/managed-turn-recovery-service.d.ts +86 -0
- package/dist/src/managed-turn-recovery-service.js +145 -0
- package/dist/src/managed-turn-recovery-service.js.map +1 -0
- package/dist/src/mutation-transaction.d.ts +48 -0
- package/dist/src/mutation-transaction.js +73 -0
- package/dist/src/mutation-transaction.js.map +1 -0
- package/dist/src/native-thread-lifecycle-cli-adapter.d.ts +154 -0
- package/dist/src/native-thread-lifecycle-cli-adapter.js +786 -0
- package/dist/src/native-thread-lifecycle-cli-adapter.js.map +1 -0
- package/dist/src/native-thread-lifecycle-ledger-cli-adapter.d.ts +25 -0
- package/dist/src/native-thread-lifecycle-ledger-cli-adapter.js +50 -0
- package/dist/src/native-thread-lifecycle-ledger-cli-adapter.js.map +1 -0
- package/dist/src/native-thread-lifecycle-query-service.d.ts +75 -0
- package/dist/src/native-thread-lifecycle-query-service.js +297 -0
- package/dist/src/native-thread-lifecycle-query-service.js.map +1 -0
- package/dist/src/native-thread-lifecycle-recovery-adapter.d.ts +45 -0
- package/dist/src/native-thread-lifecycle-recovery-adapter.js +154 -0
- package/dist/src/native-thread-lifecycle-recovery-adapter.js.map +1 -0
- package/dist/src/native-thread-lifecycle-recovery-service.d.ts +211 -0
- package/dist/src/native-thread-lifecycle-recovery-service.js +1093 -0
- package/dist/src/native-thread-lifecycle-recovery-service.js.map +1 -0
- package/dist/src/native-thread-resume-snapshot-policy.d.ts +73 -0
- package/dist/src/native-thread-resume-snapshot-policy.js +218 -0
- package/dist/src/native-thread-resume-snapshot-policy.js.map +1 -0
- package/dist/src/native-thread-resume-snapshot.d.ts +3 -61
- package/dist/src/native-thread-resume-snapshot.js +2 -143
- package/dist/src/native-thread-resume-snapshot.js.map +1 -1
- package/dist/src/native-thread-transition-application.d.ts +147 -0
- package/dist/src/native-thread-transition-application.js +974 -0
- package/dist/src/native-thread-transition-application.js.map +1 -0
- package/dist/src/native-thread-transition-policy.d.ts +127 -0
- package/dist/src/native-thread-transition-policy.js +154 -0
- package/dist/src/native-thread-transition-policy.js.map +1 -0
- package/dist/src/native-thread-transition-resource-adapter.d.ts +12 -0
- package/dist/src/native-thread-transition-resource-adapter.js +44 -0
- package/dist/src/native-thread-transition-resource-adapter.js.map +1 -0
- package/dist/src/native-thread-transition-settlement-service.d.ts +94 -0
- package/dist/src/native-thread-transition-settlement-service.js +134 -0
- package/dist/src/native-thread-transition-settlement-service.js.map +1 -0
- package/dist/src/native-thread-transition-verification-adapter.d.ts +62 -0
- package/dist/src/native-thread-transition-verification-adapter.js +451 -0
- package/dist/src/native-thread-transition-verification-adapter.js.map +1 -0
- package/dist/src/openclaw-callback-transport.d.ts +69 -0
- package/dist/src/openclaw-callback-transport.js +583 -0
- package/dist/src/openclaw-callback-transport.js.map +1 -0
- package/dist/src/openclaw-plugin-callback-adapter.d.ts +1 -0
- package/dist/src/openclaw-plugin-callback-adapter.js +423 -0
- package/dist/src/openclaw-plugin-callback-adapter.js.map +1 -0
- package/dist/src/openclaw-plugin-command-adapter.d.ts +16 -0
- package/dist/src/openclaw-plugin-command-adapter.js +1868 -0
- package/dist/src/openclaw-plugin-command-adapter.js.map +1 -0
- package/dist/src/openclaw-plugin-helpers.d.ts +27 -4
- package/dist/src/openclaw-plugin-helpers.js +356 -81
- package/dist/src/openclaw-plugin-helpers.js.map +1 -1
- package/dist/src/openclaw-plugin-schemas.d.ts +358 -0
- package/dist/src/openclaw-plugin-schemas.js +366 -0
- package/dist/src/openclaw-plugin-schemas.js.map +1 -0
- package/dist/src/openclaw-plugin-supervisor.d.ts +6 -0
- package/dist/src/openclaw-plugin-supervisor.js +123 -0
- package/dist/src/openclaw-plugin-supervisor.js.map +1 -0
- package/dist/src/openclaw-plugin.js +7 -2212
- package/dist/src/openclaw-plugin.js.map +1 -1
- package/dist/src/openclaw-private-authority-offers.d.ts +22 -0
- package/dist/src/openclaw-private-authority-offers.js +177 -0
- package/dist/src/openclaw-private-authority-offers.js.map +1 -0
- package/dist/src/protocol.d.ts +5 -0
- package/dist/src/protocol.js +59 -3
- package/dist/src/protocol.js.map +1 -1
- package/dist/src/session-store.d.ts +1 -0
- package/dist/src/session-store.js +84 -106
- package/dist/src/session-store.js.map +1 -1
- package/dist/src/store.d.ts +1 -0
- package/dist/src/store.js +5 -2
- package/dist/src/store.js.map +1 -1
- package/dist/src/terminal-acceptance-application-service.d.ts +65 -0
- package/dist/src/terminal-acceptance-application-service.js +63 -0
- package/dist/src/terminal-acceptance-application-service.js.map +1 -0
- package/dist/src/terminal-acceptance-cli-adapter.d.ts +210 -0
- package/dist/src/terminal-acceptance-cli-adapter.js +957 -0
- package/dist/src/terminal-acceptance-cli-adapter.js.map +1 -0
- package/dist/src/terminal-action-projection.d.ts +309 -0
- package/dist/src/terminal-action-projection.js +376 -0
- package/dist/src/terminal-action-projection.js.map +1 -0
- package/dist/src/terminal-agent-bridge.d.ts +3 -0
- package/dist/src/terminal-agent-bridge.js +29 -8
- package/dist/src/terminal-agent-bridge.js.map +1 -1
- package/dist/src/terminal-authority-policy.d.ts +141 -0
- package/dist/src/terminal-authority-policy.js +367 -0
- package/dist/src/terminal-authority-policy.js.map +1 -0
- package/dist/src/terminal-binding-authority.d.ts +118 -0
- package/dist/src/terminal-binding-authority.js +245 -0
- package/dist/src/terminal-binding-authority.js.map +1 -0
- package/dist/src/terminal-binding-reconciliation-service.d.ts +75 -0
- package/dist/src/terminal-binding-reconciliation-service.js +73 -0
- package/dist/src/terminal-binding-reconciliation-service.js.map +1 -0
- package/dist/src/terminal-command-cli-adapter.d.ts +380 -0
- package/dist/src/terminal-command-cli-adapter.js +3288 -0
- package/dist/src/terminal-command-cli-adapter.js.map +1 -0
- package/dist/src/terminal-control-ref.d.ts +4 -0
- package/dist/src/terminal-control-ref.js +11 -8
- package/dist/src/terminal-control-ref.js.map +1 -1
- package/dist/src/terminal-delegate-cli-adapter.d.ts +41 -0
- package/dist/src/terminal-delegate-cli-adapter.js +242 -0
- package/dist/src/terminal-delegate-cli-adapter.js.map +1 -0
- package/dist/src/terminal-dispatch-abort.d.ts +22 -0
- package/dist/src/terminal-dispatch-abort.js +30 -0
- package/dist/src/terminal-dispatch-abort.js.map +1 -0
- package/dist/src/terminal-dispatch-application.d.ts +115 -0
- package/dist/src/terminal-dispatch-application.js +478 -0
- package/dist/src/terminal-dispatch-application.js.map +1 -0
- package/dist/src/terminal-dispatch-capability.d.ts +63 -0
- package/dist/src/terminal-dispatch-capability.js +133 -0
- package/dist/src/terminal-dispatch-capability.js.map +1 -0
- package/dist/src/terminal-dispatch-completion-cli-adapter.d.ts +22 -0
- package/dist/src/terminal-dispatch-completion-cli-adapter.js +96 -0
- package/dist/src/terminal-dispatch-completion-cli-adapter.js.map +1 -0
- package/dist/src/terminal-dispatch-composition.d.ts +79 -0
- package/dist/src/terminal-dispatch-composition.js +2 -0
- package/dist/src/terminal-dispatch-composition.js.map +1 -0
- package/dist/src/terminal-dispatch-execution.d.ts +290 -0
- package/dist/src/terminal-dispatch-execution.js +916 -0
- package/dist/src/terminal-dispatch-execution.js.map +1 -0
- package/dist/src/terminal-dispatch-ledger-codec.d.ts +110 -0
- package/dist/src/terminal-dispatch-ledger-codec.js +399 -0
- package/dist/src/terminal-dispatch-ledger-codec.js.map +1 -0
- package/dist/src/terminal-dispatch-policy.d.ts +93 -0
- package/dist/src/terminal-dispatch-policy.js +122 -0
- package/dist/src/terminal-dispatch-policy.js.map +1 -0
- package/dist/src/terminal-dispatch-presenter.d.ts +65 -0
- package/dist/src/terminal-dispatch-presenter.js +258 -0
- package/dist/src/terminal-dispatch-presenter.js.map +1 -0
- package/dist/src/terminal-dispatch-receipt.d.ts +79 -0
- package/dist/src/terminal-dispatch-receipt.js +314 -0
- package/dist/src/terminal-dispatch-receipt.js.map +1 -0
- package/dist/src/terminal-dispatch-recovery-cli-adapter.d.ts +132 -0
- package/dist/src/terminal-dispatch-recovery-cli-adapter.js +1330 -0
- package/dist/src/terminal-dispatch-recovery-cli-adapter.js.map +1 -0
- package/dist/src/terminal-dispatch-recovery-service.d.ts +271 -0
- package/dist/src/terminal-dispatch-recovery-service.js +374 -0
- package/dist/src/terminal-dispatch-recovery-service.js.map +1 -0
- package/dist/src/terminal-dispatch-repository-cli-adapter.d.ts +35 -0
- package/dist/src/terminal-dispatch-repository-cli-adapter.js +483 -0
- package/dist/src/terminal-dispatch-repository-cli-adapter.js.map +1 -0
- package/dist/src/terminal-handoff-application-service.d.ts +7 -0
- package/dist/src/terminal-handoff-application-service.js +18 -0
- package/dist/src/terminal-handoff-application-service.js.map +1 -0
- package/dist/src/terminal-handoff-cli-adapter.d.ts +229 -0
- package/dist/src/terminal-handoff-cli-adapter.js +1389 -0
- package/dist/src/terminal-handoff-cli-adapter.js.map +1 -0
- package/dist/src/terminal-handoff-facts.d.ts +12 -0
- package/dist/src/terminal-handoff-facts.js +16 -0
- package/dist/src/terminal-handoff-facts.js.map +1 -0
- package/dist/src/terminal-identity-authority-cli-adapter.d.ts +318 -0
- package/dist/src/terminal-identity-authority-cli-adapter.js +1072 -0
- package/dist/src/terminal-identity-authority-cli-adapter.js.map +1 -0
- package/dist/src/terminal-identity-authority-service.d.ts +48 -0
- package/dist/src/terminal-identity-authority-service.js +45 -0
- package/dist/src/terminal-identity-authority-service.js.map +1 -0
- package/dist/src/terminal-list-cli-adapter.d.ts +274 -0
- package/dist/src/terminal-list-cli-adapter.js +2444 -0
- package/dist/src/terminal-list-cli-adapter.js.map +1 -0
- package/dist/src/terminal-list-renderer.d.ts +34 -0
- package/dist/src/terminal-list-renderer.js +643 -0
- package/dist/src/terminal-list-renderer.js.map +1 -0
- package/dist/src/terminal-maintenance-cli-adapter.d.ts +102 -0
- package/dist/src/terminal-maintenance-cli-adapter.js +1059 -0
- package/dist/src/terminal-maintenance-cli-adapter.js.map +1 -0
- package/dist/src/terminal-monitor-application-service.d.ts +275 -0
- package/dist/src/terminal-monitor-application-service.js +982 -0
- package/dist/src/terminal-monitor-application-service.js.map +1 -0
- package/dist/src/terminal-monitor-cli-adapter.d.ts +130 -0
- package/dist/src/terminal-monitor-cli-adapter.js +442 -0
- package/dist/src/terminal-monitor-cli-adapter.js.map +1 -0
- package/dist/src/terminal-monitor-decision-policy.d.ts +98 -0
- package/dist/src/terminal-monitor-decision-policy.js +246 -0
- package/dist/src/terminal-monitor-decision-policy.js.map +1 -0
- package/dist/src/terminal-monitor-launch-plan.d.ts +45 -0
- package/dist/src/terminal-monitor-launch-plan.js +94 -0
- package/dist/src/terminal-monitor-launch-plan.js.map +1 -0
- package/dist/src/terminal-monitor-ownership-policy.d.ts +31 -0
- package/dist/src/terminal-monitor-ownership-policy.js +64 -0
- package/dist/src/terminal-monitor-ownership-policy.js.map +1 -0
- package/dist/src/terminal-monitor-poll-policy.d.ts +48 -0
- package/dist/src/terminal-monitor-poll-policy.js +67 -0
- package/dist/src/terminal-monitor-poll-policy.js.map +1 -0
- package/dist/src/terminal-monitor-reconciliation-eligibility.d.ts +53 -0
- package/dist/src/terminal-monitor-reconciliation-eligibility.js +114 -0
- package/dist/src/terminal-monitor-reconciliation-eligibility.js.map +1 -0
- package/dist/src/terminal-monitor-state-cli-adapter.d.ts +106 -0
- package/dist/src/terminal-monitor-state-cli-adapter.js +1492 -0
- package/dist/src/terminal-monitor-state-cli-adapter.js.map +1 -0
- package/dist/src/terminal-monitor-state-reconciliation-service.d.ts +87 -0
- package/dist/src/terminal-monitor-state-reconciliation-service.js +106 -0
- package/dist/src/terminal-monitor-state-reconciliation-service.js.map +1 -0
- package/dist/src/terminal-monitor-supervision-cli-adapter.d.ts +122 -0
- package/dist/src/terminal-monitor-supervision-cli-adapter.js +685 -0
- package/dist/src/terminal-monitor-supervision-cli-adapter.js.map +1 -0
- package/dist/src/terminal-process-facts.d.ts +2 -0
- package/dist/src/terminal-process-facts.js +19 -0
- package/dist/src/terminal-process-facts.js.map +1 -0
- package/dist/src/terminal-process-source.d.ts +6 -4
- package/dist/src/terminal-process-source.js +25 -20
- package/dist/src/terminal-process-source.js.map +1 -1
- package/dist/src/terminal-runtime-cli-adapter.d.ts +80 -0
- package/dist/src/terminal-runtime-cli-adapter.js +488 -0
- package/dist/src/terminal-runtime-cli-adapter.js.map +1 -0
- package/dist/src/terminal-scoped-approval-authority.d.ts +62 -0
- package/dist/src/terminal-scoped-approval-authority.js +281 -0
- package/dist/src/terminal-scoped-approval-authority.js.map +1 -0
- package/dist/src/terminal-selector-projection-service.d.ts +26 -0
- package/dist/src/terminal-selector-projection-service.js +81 -0
- package/dist/src/terminal-selector-projection-service.js.map +1 -0
- package/dist/src/terminal-status-cli-adapter.d.ts +126 -0
- package/dist/src/terminal-status-cli-adapter.js +577 -0
- package/dist/src/terminal-status-cli-adapter.js.map +1 -0
- package/dist/src/terminal-status-facts.d.ts +56 -0
- package/dist/src/terminal-status-facts.js +199 -0
- package/dist/src/terminal-status-facts.js.map +1 -0
- package/dist/src/terminal-submission-acceptance.d.ts +62 -145
- package/dist/src/terminal-submission-acceptance.js +555 -222
- package/dist/src/terminal-submission-acceptance.js.map +1 -1
- package/dist/src/terminal-submission-facts.d.ts +123 -0
- package/dist/src/terminal-submission-facts.js +205 -0
- package/dist/src/terminal-submission-facts.js.map +1 -0
- package/dist/src/terminal-turn-binding-authority-cli-adapter.d.ts +14 -0
- package/dist/src/terminal-turn-binding-authority-cli-adapter.js +90 -0
- package/dist/src/terminal-turn-binding-authority-cli-adapter.js.map +1 -0
- package/dist/src/terminal-watch-callback-cli-adapter.d.ts +20 -0
- package/dist/src/terminal-watch-callback-cli-adapter.js +55 -0
- package/dist/src/terminal-watch-callback-cli-adapter.js.map +1 -0
- package/dist/src/terminal-watch-cli-adapter.d.ts +64 -0
- package/dist/src/terminal-watch-cli-adapter.js +508 -0
- package/dist/src/terminal-watch-cli-adapter.js.map +1 -0
- package/dist/src/terminal-watch-service.d.ts +97 -0
- package/dist/src/terminal-watch-service.js +714 -0
- package/dist/src/terminal-watch-service.js.map +1 -0
- package/dist/src/terminal-watch-store.d.ts +149 -0
- package/dist/src/terminal-watch-store.js +861 -0
- package/dist/src/terminal-watch-store.js.map +1 -0
- package/dist/src/value-guards.d.ts +4 -0
- package/dist/src/value-guards.js +12 -0
- package/dist/src/value-guards.js.map +1 -0
- package/dist/src/verified-dead-agent-policy.d.ts +192 -0
- package/dist/src/verified-dead-agent-policy.js +262 -0
- package/dist/src/verified-dead-agent-policy.js.map +1 -0
- package/docs/quickstart-herdr.md +8 -0
- package/docs/quickstart-tmux.md +33 -6
- package/openclaw.plugin.json +11 -3
- package/package.json +3 -1
- package/templates/openclaw-skills/agent-knock-knock/SKILL.md +58 -40
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { executorForConversation, sessionIdForConversation, turnIdForConversation } from "./protocol.js";
|
|
3
|
+
import { loadManagedSession } from "./session-store.js";
|
|
4
|
+
import { ensureStoreWritable, STORE_SESSION_AUTHORITY_PROTOCOL } from "./store.js";
|
|
5
|
+
import { terminalControlAliasMatches, terminalControlsShareIncarnation } from "./terminal-authority-policy.js";
|
|
6
|
+
import { migratedTerminalBindingMatches } from "./terminal-dispatch-execution.js";
|
|
7
|
+
import { terminalControlFromTakeover } from "./terminal-runtime-cli-adapter.js";
|
|
8
|
+
import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
|
|
9
|
+
class TurnBindingSupersededError extends Error {
|
|
10
|
+
code = "AKK_TURN_BINDING_SUPERSEDED";
|
|
11
|
+
constructor(message) {
|
|
12
|
+
super(message);
|
|
13
|
+
this.name = "TurnBindingSupersededError";
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
/** Own the Store-backed current-Turn binding fence used by CLI mutations. */
|
|
17
|
+
export function createTerminalTurnBindingAuthorityCliAdapter(dependencies) {
|
|
18
|
+
return Object.freeze({
|
|
19
|
+
assertCurrent(conversation, operation) {
|
|
20
|
+
assertTurnBindingCurrent(dependencies, conversation, operation);
|
|
21
|
+
},
|
|
22
|
+
superseded(error) {
|
|
23
|
+
return error instanceof TurnBindingSupersededError
|
|
24
|
+
? { code: error.code, message: error.message }
|
|
25
|
+
: undefined;
|
|
26
|
+
}
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
function assertTurnBindingCurrent(dependencies, conversation, operation) {
|
|
30
|
+
const storeDir = dependencies.storeDirForConversation(conversation);
|
|
31
|
+
if (!storeDir)
|
|
32
|
+
return;
|
|
33
|
+
const takeover = isRecord(conversation.native_session_takeover)
|
|
34
|
+
? conversation.native_session_takeover
|
|
35
|
+
: undefined;
|
|
36
|
+
// Delegated, non-terminal Turns predate first-class Session authority.
|
|
37
|
+
if (!isRecord(takeover?.terminal_control))
|
|
38
|
+
return;
|
|
39
|
+
const terminalControl = terminalControlFromTakeover(takeover);
|
|
40
|
+
if (!terminalControl) {
|
|
41
|
+
throw new Error(`cannot ${operation} Turn ${turnIdForConversation(conversation)}: its ` +
|
|
42
|
+
"terminal binding is malformed");
|
|
43
|
+
}
|
|
44
|
+
// The writable-Store upgrade must precede the authoritative Session read.
|
|
45
|
+
const manifest = ensureStoreWritable(storeDir);
|
|
46
|
+
if (manifest.writer_protocol < STORE_SESSION_AUTHORITY_PROTOCOL) {
|
|
47
|
+
throw new Error(`cannot ${operation} Turn ${turnIdForConversation(conversation)}: ` +
|
|
48
|
+
"its Store has no protocol-3 Session authority");
|
|
49
|
+
}
|
|
50
|
+
const session = loadManagedSession(storeDir, sessionIdForConversation(conversation));
|
|
51
|
+
const bindingId = stringValue(conversation.terminal_binding_id);
|
|
52
|
+
const bindingGeneration = Number(conversation.terminal_binding_generation);
|
|
53
|
+
const turnNativeThreadId = stringValue(conversation.native_thread_id) ??
|
|
54
|
+
stringValue(takeover.terminal_agent_session_id);
|
|
55
|
+
const exactModernBinding = Boolean(bindingId && Number.isSafeInteger(bindingGeneration) &&
|
|
56
|
+
session.status === "bound" && session.binding?.binding_id === bindingId &&
|
|
57
|
+
session.binding.generation === bindingGeneration &&
|
|
58
|
+
session.binding.native_thread_id === turnNativeThreadId);
|
|
59
|
+
const compatibleMigratedBinding = Boolean(!bindingId && !Number.isSafeInteger(bindingGeneration) &&
|
|
60
|
+
session.lineage.created_by === "migration" && !session.last_transition_id &&
|
|
61
|
+
migratedTerminalTurnMatchesSessionBinding({
|
|
62
|
+
conversation, takeover, terminalControl, session, turnNativeThreadId
|
|
63
|
+
}));
|
|
64
|
+
if (!exactModernBinding && !compatibleMigratedBinding) {
|
|
65
|
+
throw new TurnBindingSupersededError(`cannot ${operation} Turn ${turnIdForConversation(conversation)}: its ` +
|
|
66
|
+
"Session binding generation is no longer current");
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
function migratedTerminalTurnMatchesSessionBinding({ conversation, takeover, terminalControl, session, turnNativeThreadId }) {
|
|
70
|
+
const binding = session.binding;
|
|
71
|
+
const terminalId = stringValue(takeover.native_session_id);
|
|
72
|
+
return migratedTerminalBindingMatches({
|
|
73
|
+
session,
|
|
74
|
+
agent: executorForConversation(conversation).kind,
|
|
75
|
+
workspaceMatches: path.resolve(session.workspace) === path.resolve(conversation.workspace),
|
|
76
|
+
terminalId,
|
|
77
|
+
terminalAliasMatches: Boolean(binding && terminalId &&
|
|
78
|
+
terminalControlAliasMatches(terminalId, terminalControl, binding.terminal_id, binding.terminal_control)),
|
|
79
|
+
terminalIncarnationMatches: Boolean(binding &&
|
|
80
|
+
terminalControlsShareIncarnation(binding.terminal_control, terminalControl)),
|
|
81
|
+
pid: Number(takeover.terminal_agent_pid),
|
|
82
|
+
nativeThreadId: turnNativeThreadId,
|
|
83
|
+
processUuid: stringValue(takeover.terminal_agent_process_uuid),
|
|
84
|
+
processBirth: stringValue(takeover.terminal_agent_process_birth),
|
|
85
|
+
rollout: isRecord(takeover.terminal_agent_rollout)
|
|
86
|
+
? takeover.terminal_agent_rollout
|
|
87
|
+
: undefined
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=terminal-turn-binding-authority-cli-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"terminal-turn-binding-authority-cli-adapter.js","sourceRoot":"","sources":["../../src/terminal-turn-binding-authority-cli-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { CallbackSpawnSync } from "./openclaw-callback-transport.js";
|
|
2
|
+
export type TerminalWatchCallbackEvent = "approval_required" | "completed" | "failed" | "timed_out" | "invalidated" | "cancelled";
|
|
3
|
+
export interface TerminalWatchCallbackInput {
|
|
4
|
+
watchId: string;
|
|
5
|
+
idempotencyKey: string;
|
|
6
|
+
event: TerminalWatchCallbackEvent;
|
|
7
|
+
agent: "codex" | "claude";
|
|
8
|
+
terminalId: string;
|
|
9
|
+
openclawSession: string;
|
|
10
|
+
openclawBin?: string;
|
|
11
|
+
detail?: string;
|
|
12
|
+
completionText?: string;
|
|
13
|
+
}
|
|
14
|
+
export interface TerminalWatchCallbackCliAdapter {
|
|
15
|
+
deliver(input: TerminalWatchCallbackInput): void;
|
|
16
|
+
}
|
|
17
|
+
export declare function createTerminalWatchCallbackCliAdapter(options?: {
|
|
18
|
+
environment?: () => NodeJS.ProcessEnv;
|
|
19
|
+
spawnSync?: CallbackSpawnSync;
|
|
20
|
+
}): TerminalWatchCallbackCliAdapter;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { createOpenClawCallbackTransport, parseChatSendAcknowledgement } from "./openclaw-callback-transport.js";
|
|
2
|
+
export function createTerminalWatchCallbackCliAdapter(options = {}) {
|
|
3
|
+
const transport = createOpenClawCallbackTransport({
|
|
4
|
+
now: () => new Date(),
|
|
5
|
+
environment: options.environment ?? (() => process.env),
|
|
6
|
+
redactConversation: () => ({}),
|
|
7
|
+
recordCallbackProcessDelivery: () => { },
|
|
8
|
+
...(options.spawnSync ? { spawnSync: options.spawnSync } : {})
|
|
9
|
+
});
|
|
10
|
+
return Object.freeze({
|
|
11
|
+
deliver(input) {
|
|
12
|
+
const delivery = transport.deliverChatSend({
|
|
13
|
+
openclawBin: input.openclawBin,
|
|
14
|
+
params: {
|
|
15
|
+
sessionKey: input.openclawSession,
|
|
16
|
+
message: terminalWatchCallbackMessage(input),
|
|
17
|
+
idempotencyKey: input.idempotencyKey,
|
|
18
|
+
deliver: true
|
|
19
|
+
}
|
|
20
|
+
});
|
|
21
|
+
if (delivery.status !== 0) {
|
|
22
|
+
throw new Error(delivery.stderr || delivery.stdout ||
|
|
23
|
+
`Terminal Watch callback failed with status ${delivery.status}`);
|
|
24
|
+
}
|
|
25
|
+
const acknowledgement = parseChatSendAcknowledgement(delivery.stdout, input.idempotencyKey);
|
|
26
|
+
if (acknowledgement.status === "error" ||
|
|
27
|
+
acknowledgement.status === "timeout") {
|
|
28
|
+
throw new Error(`Terminal Watch chat.send was not accepted: ${acknowledgement.status}`);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
function terminalWatchCallbackMessage(input) {
|
|
34
|
+
const eventInstruction = input.event === "approval_required"
|
|
35
|
+
? "Tell the user that the observed TUI task is waiting for approval and ask the human to inspect and decide in the named live TUI. Do not call any AKK approval tool or action, do not send approval keys, and do not use autoApprove."
|
|
36
|
+
: input.event === "completed"
|
|
37
|
+
? "Tell the user that the human-started TUI task completed and summarize only the bounded completion text below."
|
|
38
|
+
: "Tell the user that Terminal Watch stopped without a verified successful completion and explain the exact reason below.";
|
|
39
|
+
return [
|
|
40
|
+
"Continue this OpenClaw conversation from the Agent Knock Knock Terminal Watch event below.",
|
|
41
|
+
"This is an observation of a task started by the human directly in Codex or Claude Code. It is not an AKK Turn and AKK did not send terminal input.",
|
|
42
|
+
eventInstruction,
|
|
43
|
+
"Do not poll files, processes, terminal panes, stdout, or stderr. Use only this structured event.",
|
|
44
|
+
"",
|
|
45
|
+
`[AKK Terminal Watch: ${input.event}]`,
|
|
46
|
+
`Watch: ${input.watchId}`,
|
|
47
|
+
`Terminal: ${input.terminalId}`,
|
|
48
|
+
`Agent: ${input.agent}`,
|
|
49
|
+
...(input.detail ? [`Detail: ${input.detail}`] : []),
|
|
50
|
+
...(input.completionText
|
|
51
|
+
? ["", "Bounded completion text:", input.completionText]
|
|
52
|
+
: [])
|
|
53
|
+
].join("\n");
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=terminal-watch-callback-cli-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"terminal-watch-callback-cli-adapter.js","sourceRoot":"","sources":["../../src/terminal-watch-callback-cli-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC7B,MAAM,kCAAkC,CAAC;AA0B1C,MAAM,UAAU,qCAAqC,CACnD,OAAO,GAGH,EAAE;IAEN,MAAM,SAAS,GAAG,+BAA+B,CAAC;QAChD,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QACrB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;QACvD,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9B,6BAA6B,EAAE,GAAG,EAAE,GAAE,CAAC;QACvC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,CAAC,KAAK;YACX,MAAM,QAAQ,GAAG,SAAS,CAAC,eAAe,CAAC;gBACzC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,MAAM,EAAE;oBACN,UAAU,EAAE,KAAK,CAAC,eAAe;oBACjC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC;oBAC5C,cAAc,EAAE,KAAK,CAAC,cAAc;oBACpC,OAAO,EAAE,IAAI;iBACd;aACF,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM;oBAClC,8CAA8C,QAAQ,CAAC,MAAM,EAAE,CAChE,CAAC;YACJ,CAAC;YACD,MAAM,eAAe,GAAG,4BAA4B,CAClD,QAAQ,CAAC,MAAM,EACf,KAAK,CAAC,cAAc,CACrB,CAAC;YACF,IACE,eAAe,CAAC,MAAM,KAAK,OAAO;gBAClC,eAAe,CAAC,MAAM,KAAK,SAAS,EACpC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,8CAA8C,eAAe,CAAC,MAAM,EAAE,CACvE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAiC;IAEjC,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,KAAK,mBAAmB;QAC1D,CAAC,CAAC,qOAAqO;QACvO,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,WAAW;YAC3B,CAAC,CAAC,+GAA+G;YACjH,CAAC,CAAC,wHAAwH,CAAC;IAC/H,OAAO;QACL,4FAA4F;QAC5F,oJAAoJ;QACpJ,gBAAgB;QAChB,kGAAkG;QAClG,EAAE;QACF,wBAAwB,KAAK,CAAC,KAAK,GAAG;QACtC,UAAU,KAAK,CAAC,OAAO,EAAE;QACzB,aAAa,KAAK,CAAC,UAAU,EAAE;QAC/B,UAAU,KAAK,CAAC,KAAK,EAAE;QACvB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,cAAc;YACtB,CAAC,CAAC,CAAC,EAAE,EAAE,0BAA0B,EAAE,KAAK,CAAC,cAAc,CAAC;YACxD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type { ClaudeAgentRow } from "./claude-terminal-agent-adapter.js";
|
|
2
|
+
import { type Conversation } from "./protocol.js";
|
|
3
|
+
import { type TerminalDispatchOwnership } from "./terminal-action-projection.js";
|
|
4
|
+
import type { TerminalControlRef } from "./terminal-control-ref.js";
|
|
5
|
+
import { type TerminalWatchCallbackCliAdapter } from "./terminal-watch-callback-cli-adapter.js";
|
|
6
|
+
export interface TerminalWatchCliOptions {
|
|
7
|
+
claudeHome?: string;
|
|
8
|
+
hardTimeoutMinutes?: number | string;
|
|
9
|
+
openclawBin?: string;
|
|
10
|
+
openclawSession?: string;
|
|
11
|
+
storeDir?: string;
|
|
12
|
+
terminal?: string;
|
|
13
|
+
watch?: string;
|
|
14
|
+
[option: string]: unknown;
|
|
15
|
+
}
|
|
16
|
+
type ExactTerminalWatchObservation = {
|
|
17
|
+
state: "available";
|
|
18
|
+
rawTerminal: Record<string, unknown>;
|
|
19
|
+
terminal: Record<string, unknown>;
|
|
20
|
+
summary: Record<string, unknown>;
|
|
21
|
+
} | {
|
|
22
|
+
state: "absent";
|
|
23
|
+
reason?: string;
|
|
24
|
+
summary: Record<string, unknown>;
|
|
25
|
+
} | {
|
|
26
|
+
state: "unavailable";
|
|
27
|
+
reason?: string;
|
|
28
|
+
summary: Record<string, unknown>;
|
|
29
|
+
};
|
|
30
|
+
export interface TerminalWatchCliDependencies {
|
|
31
|
+
acquireFileLock(lockPath: string): () => void;
|
|
32
|
+
acquireTerminalLock(storeDir: string, terminalControl: TerminalControlRef): () => void;
|
|
33
|
+
observeExactTerminal(request: {
|
|
34
|
+
options: TerminalWatchCliOptions;
|
|
35
|
+
terminalId: string;
|
|
36
|
+
}): Promise<ExactTerminalWatchObservation>;
|
|
37
|
+
loadClaudeAgentRows(options: TerminalWatchCliOptions, observation?: {
|
|
38
|
+
required?: boolean;
|
|
39
|
+
}): readonly ClaudeAgentRow[];
|
|
40
|
+
now(): Date;
|
|
41
|
+
randomUUID(): string;
|
|
42
|
+
storeDirFromOptions(options: TerminalWatchCliOptions): string;
|
|
43
|
+
terminalDispatchOwnership(terminalControl: TerminalControlRef): TerminalDispatchOwnership<Conversation, Record<string, unknown>>;
|
|
44
|
+
terminalIncarnationBlockingTurns(storeDir: string, terminalControl: TerminalControlRef): Conversation[];
|
|
45
|
+
printJson(value: unknown): void;
|
|
46
|
+
callback?: TerminalWatchCallbackCliAdapter;
|
|
47
|
+
}
|
|
48
|
+
export interface TerminalWatchCliFacade {
|
|
49
|
+
runWatch(options: TerminalWatchCliOptions): Promise<void>;
|
|
50
|
+
runUnwatch(options: TerminalWatchCliOptions): Promise<void>;
|
|
51
|
+
runWatchStatus(options: TerminalWatchCliOptions): void;
|
|
52
|
+
runReconcileWatches(options: TerminalWatchCliOptions): Promise<void>;
|
|
53
|
+
listPublicWatches(storeDir: string, options?: {
|
|
54
|
+
includeAll?: boolean;
|
|
55
|
+
}): Array<Record<string, unknown>>;
|
|
56
|
+
scanPublicWatchesForExactObservation(storeDir: string, options?: {
|
|
57
|
+
includeAll?: boolean;
|
|
58
|
+
}): {
|
|
59
|
+
watches: Array<Record<string, unknown>>;
|
|
60
|
+
activeOverlayTrusted: boolean;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
export declare function createTerminalWatchCliAdapter(dependencies: TerminalWatchCliDependencies): TerminalWatchCliFacade;
|
|
64
|
+
export {};
|