@agent-watch-ai/edge 0.2.5 → 0.3.1
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 +512 -0
- package/README.md +217 -96
- package/SECURITY.md +69 -0
- package/dist/billing/session-billing.d.ts +19 -0
- package/dist/billing/session-billing.js +52 -0
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.js +20 -0
- package/dist/cli/constants/cli.constants.d.ts +50 -4
- package/dist/cli/constants/cli.constants.js +54 -5
- package/dist/cli/context.d.ts +33 -2
- package/dist/cli/context.js +84 -14
- package/dist/cli/doctor.js +309 -32
- package/dist/cli/hook-check.d.ts +23 -0
- package/dist/cli/hook-check.js +114 -0
- package/dist/cli/hook.js +118 -7
- package/dist/cli/index.d.ts +3 -1
- package/dist/cli/index.js +3 -1
- package/dist/cli/misc.d.ts +11 -0
- package/dist/cli/misc.js +80 -4
- package/dist/cli/npx-install.d.ts +37 -0
- package/dist/cli/npx-install.js +79 -0
- package/dist/cli/open-browser.d.ts +39 -0
- package/dist/cli/open-browser.js +62 -0
- package/dist/cli/setup.d.ts +17 -8
- package/dist/cli/setup.js +439 -98
- package/dist/cli/status.js +82 -13
- package/dist/cli/toggle.d.ts +9 -0
- package/dist/cli/toggle.js +113 -0
- package/dist/cli/types/cli.types.d.ts +37 -3
- package/dist/cli/ui.d.ts +7 -0
- package/dist/cli/ui.js +10 -1
- package/dist/cli/uninstall.js +39 -2
- package/dist/cli/update.d.ts +17 -0
- package/dist/cli/update.js +76 -0
- package/dist/cli.js +100 -13
- package/dist/config/config-store.d.ts +57 -0
- package/dist/config/config-store.js +250 -12
- package/dist/config/config.d.ts +53 -6
- package/dist/config/config.js +66 -6
- package/dist/config/constants/config.constants.d.ts +113 -6
- package/dist/config/constants/config.constants.js +126 -8
- package/dist/config/destination.d.ts +24 -0
- package/dist/config/destination.js +33 -0
- package/dist/config/index.d.ts +7 -4
- package/dist/config/index.js +5 -3
- package/dist/config/repo-config.d.ts +11 -7
- package/dist/config/repo-config.js +64 -15
- package/dist/config/root-config.d.ts +72 -0
- package/dist/config/root-config.js +170 -0
- package/dist/config/schemas/config.schema.d.ts +721 -84
- package/dist/config/schemas/config.schema.js +388 -15
- package/dist/config/types/config.types.d.ts +15 -1
- package/dist/config/types/destination.types.d.ts +8 -0
- package/dist/core/async.d.ts +36 -0
- package/dist/core/async.js +68 -0
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.js +1 -1
- package/dist/core/object.d.ts +5 -0
- package/dist/core/object.js +9 -4
- package/dist/core/pipe.d.ts +0 -13
- package/dist/core/pipe.js +1 -9
- package/dist/core/types/core.types.d.ts +9 -0
- package/dist/core/types/core.types.js +0 -3
- package/dist/core/which.d.ts +14 -0
- package/dist/core/which.js +43 -3
- package/dist/credentials/budget.d.ts +9 -0
- package/dist/credentials/budget.js +16 -0
- package/dist/credentials/command-runner.d.ts +16 -0
- package/dist/credentials/command-runner.js +37 -0
- package/dist/credentials/constants/credentials.constants.d.ts +111 -0
- package/dist/credentials/constants/credentials.constants.js +112 -0
- package/dist/credentials/credential-status.d.ts +14 -0
- package/dist/credentials/credential-status.js +34 -0
- package/dist/credentials/credentials.d.ts +72 -0
- package/dist/credentials/credentials.js +253 -0
- package/dist/credentials/device-api.d.ts +64 -0
- package/dist/credentials/device-api.js +150 -0
- package/dist/credentials/device-state.d.ts +31 -0
- package/dist/credentials/device-state.js +51 -0
- package/dist/credentials/identity.d.ts +62 -0
- package/dist/credentials/identity.js +90 -0
- package/dist/credentials/index.d.ts +7 -0
- package/dist/credentials/index.js +5 -0
- package/dist/credentials/migration.d.ts +46 -0
- package/dist/credentials/migration.js +164 -0
- package/dist/credentials/schemas/device-api.schema.d.ts +77 -0
- package/dist/credentials/schemas/device-api.schema.js +33 -0
- package/dist/credentials/schemas/device-state.schema.d.ts +51 -0
- package/dist/credentials/schemas/device-state.schema.js +20 -0
- package/dist/credentials/secret-store.d.ts +54 -0
- package/dist/credentials/secret-store.js +217 -0
- package/dist/credentials/sign-in.d.ts +18 -0
- package/dist/credentials/sign-in.js +86 -0
- package/dist/credentials/token-refresher.d.ts +39 -0
- package/dist/credentials/token-refresher.js +185 -0
- package/dist/credentials/types/credentials.types.d.ts +195 -0
- package/dist/credentials/types/credentials.types.js +1 -0
- package/dist/enforcement/constants/enforcement.constants.d.ts +47 -1
- package/dist/enforcement/constants/enforcement.constants.js +56 -0
- package/dist/enforcement/decision-cache.d.ts +20 -1
- package/dist/enforcement/decision-cache.js +65 -2
- package/dist/enforcement/decision-client.d.ts +9 -8
- package/dist/enforcement/decision-client.js +62 -16
- package/dist/enforcement/enforcement.d.ts +23 -2
- package/dist/enforcement/enforcement.js +103 -15
- package/dist/enforcement/index.d.ts +4 -3
- package/dist/enforcement/index.js +3 -2
- package/dist/enforcement/types/enforcement.types.d.ts +64 -0
- package/dist/enrollment/constants/enrollment.constants.d.ts +2 -6
- package/dist/enrollment/constants/enrollment.constants.js +2 -6
- package/dist/enrollment/enrollment.d.ts +16 -0
- package/dist/enrollment/enrollment.js +54 -0
- package/dist/enrollment/index.d.ts +3 -7
- package/dist/enrollment/index.js +1 -1
- package/dist/enrollment/types/enrollment.types.d.ts +9 -13
- package/dist/events/constants/enrich.constants.d.ts +15 -0
- package/dist/events/constants/enrich.constants.js +15 -0
- package/dist/events/constants/events.constants.d.ts +6 -2
- package/dist/events/constants/events.constants.js +5 -1
- package/dist/events/enrich.js +92 -10
- package/dist/events/event-id.d.ts +0 -8
- package/dist/events/event-id.js +0 -10
- package/dist/events/index.d.ts +2 -2
- package/dist/events/index.js +1 -1
- package/dist/events/product-event.d.ts +9 -6
- package/dist/events/types/repo-snapshot.types.d.ts +7 -0
- package/dist/events/types/session-billing.types.d.ts +16 -0
- package/dist/events/types/session-billing.types.js +1 -0
- package/dist/feature/constants/feature.constants.d.ts +7 -0
- package/dist/feature/constants/feature.constants.js +7 -0
- package/dist/feature/index.d.ts +1 -1
- package/dist/feature/index.js +1 -1
- package/dist/feature/ticket-candidates.d.ts +14 -0
- package/dist/feature/ticket-candidates.js +26 -8
- package/dist/git/blob-hash.d.ts +21 -0
- package/dist/git/blob-hash.js +69 -0
- package/dist/git/checkout-root.d.ts +27 -0
- package/dist/git/checkout-root.js +75 -0
- package/dist/git/constants/git.constants.d.ts +160 -0
- package/dist/git/constants/git.constants.js +181 -0
- package/dist/git/fingerprint.d.ts +74 -0
- package/dist/git/fingerprint.js +219 -0
- package/dist/git/gate-checkout.d.ts +44 -0
- package/dist/git/gate-checkout.js +201 -0
- package/dist/git/git-context.d.ts +45 -0
- package/dist/git/git-context.js +61 -3
- package/dist/git/index.d.ts +4 -2
- package/dist/git/index.js +2 -1
- package/dist/git/manifest-repository.d.ts +13 -0
- package/dist/git/manifest-repository.js +92 -0
- package/dist/git/repo-snapshot.d.ts +29 -3
- package/dist/git/repo-snapshot.js +110 -7
- package/dist/git/repository-root.d.ts +39 -0
- package/dist/git/repository-root.js +131 -0
- package/dist/git/types/git.types.d.ts +55 -0
- package/dist/git/types/repository-root.types.d.ts +11 -0
- package/dist/git/types/repository-root.types.js +1 -0
- package/dist/git/types/snapshot.types.d.ts +9 -0
- package/dist/pipeline/constants/pipeline.constants.d.ts +7 -0
- package/dist/pipeline/constants/pipeline.constants.js +7 -0
- package/dist/pipeline/hook-pipeline.js +360 -32
- package/dist/pipeline/types/pipeline.types.d.ts +39 -4
- package/dist/privacy/constants/privacy.constants.js +15 -1
- package/dist/privacy/index.d.ts +1 -0
- package/dist/privacy/index.js +1 -0
- package/dist/privacy/product-capture.d.ts +12 -0
- package/dist/privacy/product-capture.js +73 -0
- package/dist/privacy/sanitizer.d.ts +21 -3
- package/dist/privacy/sanitizer.js +52 -8
- package/dist/process/ancestors.d.ts +39 -0
- package/dist/process/ancestors.js +121 -0
- package/dist/process/constants/process.constants.d.ts +34 -0
- package/dist/process/constants/process.constants.js +34 -0
- package/dist/process/index.d.ts +7 -0
- package/dist/process/index.js +2 -0
- package/dist/process/types/process.types.d.ts +23 -0
- package/dist/process/types/process.types.js +1 -0
- package/dist/providers/antigravity/antigravity.adapter.d.ts +12 -1
- package/dist/providers/antigravity/antigravity.adapter.js +21 -3
- package/dist/providers/antigravity/antigravity.detect.d.ts +0 -9
- package/dist/providers/antigravity/antigravity.detect.js +1 -1
- package/dist/providers/antigravity/antigravity.provider.js +3 -2
- package/dist/providers/antigravity/constants/antigravity.constants.d.ts +2 -0
- package/dist/providers/antigravity/constants/antigravity.constants.js +2 -0
- package/dist/providers/claude/claude.adapter.d.ts +11 -1
- package/dist/providers/claude/claude.adapter.js +26 -5
- package/dist/providers/claude/claude.otel.d.ts +32 -18
- package/dist/providers/claude/claude.otel.js +81 -6
- package/dist/providers/claude/claude.provider.js +5 -2
- package/dist/providers/claude/constants/claude.constants.d.ts +2 -0
- package/dist/providers/claude/constants/claude.constants.js +2 -0
- package/dist/providers/claude/constants/claude.otel.constants.d.ts +4 -0
- package/dist/providers/claude/constants/claude.otel.constants.js +8 -0
- package/dist/providers/codex/codex.adapter.d.ts +15 -1
- package/dist/providers/codex/codex.adapter.js +29 -5
- package/dist/providers/codex/codex.otel.d.ts +24 -2
- package/dist/providers/codex/codex.otel.js +147 -30
- package/dist/providers/codex/codex.provider.js +5 -2
- package/dist/providers/codex/constants/codex.constants.d.ts +2 -0
- package/dist/providers/codex/constants/codex.constants.js +16 -0
- package/dist/providers/codex/constants/codex.otel.constants.d.ts +5 -0
- package/dist/providers/codex/constants/codex.otel.constants.js +5 -0
- package/dist/providers/constants/provider.constants.d.ts +0 -3
- package/dist/providers/constants/provider.constants.js +0 -3
- package/dist/providers/cursor/constants/cursor.constants.d.ts +7 -0
- package/dist/providers/cursor/constants/cursor.constants.js +7 -0
- package/dist/providers/cursor/cursor.adapter.d.ts +33 -1
- package/dist/providers/cursor/cursor.adapter.js +52 -3
- package/dist/providers/cursor/cursor.detect.d.ts +0 -7
- package/dist/providers/cursor/cursor.detect.js +1 -1
- package/dist/providers/cursor/cursor.provider.js +5 -2
- package/dist/providers/gemini/constants/gemini.constants.d.ts +9 -0
- package/dist/providers/gemini/constants/gemini.constants.js +9 -0
- package/dist/providers/gemini/constants/gemini.otel.constants.d.ts +3 -1
- package/dist/providers/gemini/constants/gemini.otel.constants.js +3 -0
- package/dist/providers/gemini/gemini.adapter.d.ts +14 -1
- package/dist/providers/gemini/gemini.adapter.js +25 -5
- package/dist/providers/gemini/gemini.detect.d.ts +0 -7
- package/dist/providers/gemini/gemini.detect.js +1 -1
- package/dist/providers/gemini/gemini.otel.d.ts +19 -20
- package/dist/providers/gemini/gemini.otel.js +121 -17
- package/dist/providers/gemini/gemini.provider.js +2 -1
- package/dist/providers/index.d.ts +1 -1
- package/dist/providers/index.js +1 -1
- package/dist/providers/loaders.d.ts +10 -0
- package/dist/providers/loaders.js +40 -0
- package/dist/providers/provider.d.ts +11 -0
- package/dist/providers/provider.js +1 -1
- package/dist/providers/registry.d.ts +11 -8
- package/dist/providers/registry.js +11 -15
- package/dist/providers/shared/constants/hook-refusal.constants.d.ts +7 -0
- package/dist/providers/shared/constants/hook-refusal.constants.js +7 -0
- package/dist/providers/shared/constants/shell-directories.constants.d.ts +30 -0
- package/dist/providers/shared/constants/shell-directories.constants.js +39 -0
- package/dist/providers/shared/constants/tooling.constants.d.ts +18 -2
- package/dist/providers/shared/constants/tooling.constants.js +19 -3
- package/dist/providers/shared/event-builder.d.ts +12 -14
- package/dist/providers/shared/event-builder.js +20 -14
- package/dist/providers/shared/exporter-allowlist.d.ts +20 -0
- package/dist/providers/shared/exporter-allowlist.js +49 -0
- package/dist/providers/shared/hook-config.d.ts +2 -21
- package/dist/providers/shared/hook-config.js +5 -4
- package/dist/providers/shared/hook-refusal.d.ts +12 -0
- package/dist/providers/shared/hook-refusal.js +17 -1
- package/dist/providers/shared/install-record.d.ts +12 -2
- package/dist/providers/shared/install-record.js +5 -2
- package/dist/providers/shared/shell-directories.d.ts +24 -0
- package/dist/providers/shared/shell-directories.js +90 -0
- package/dist/providers/shared/tooling.d.ts +12 -1
- package/dist/providers/shared/tooling.js +18 -0
- package/dist/providers/shared/types/adapter.types.d.ts +1 -2
- package/dist/providers/types/provider.types.d.ts +57 -1
- package/dist/snapshot/constants/snapshot.constants.d.ts +32 -0
- package/dist/snapshot/constants/snapshot.constants.js +33 -0
- package/dist/snapshot/snapshot-event.js +52 -11
- package/dist/snapshot/snapshot-pipeline.js +1 -1
- package/dist/snapshot/types/snapshot.types.d.ts +2 -0
- package/dist/storage/atomic-file.d.ts +7 -0
- package/dist/storage/atomic-file.js +1 -1
- package/dist/storage/constants/storage.constants.d.ts +17 -0
- package/dist/storage/constants/storage.constants.js +17 -0
- package/dist/storage/disabled.d.ts +13 -0
- package/dist/storage/disabled.js +24 -0
- package/dist/storage/index.d.ts +2 -0
- package/dist/storage/index.js +2 -0
- package/dist/storage/paths.js +3 -2
- package/dist/storage/schemas/storage.schema.d.ts +72 -0
- package/dist/storage/schemas/storage.schema.js +6 -0
- package/dist/storage/sweep-marker.d.ts +19 -0
- package/dist/storage/sweep-marker.js +55 -0
- package/dist/storage/types/storage.types.d.ts +2 -0
- package/dist/storage/uninstalled.d.ts +58 -0
- package/dist/storage/uninstalled.js +107 -0
- package/dist/transport/auth-block.d.ts +66 -0
- package/dist/transport/auth-block.js +129 -0
- package/dist/transport/constants/transport.constants.d.ts +82 -3
- package/dist/transport/constants/transport.constants.js +83 -4
- package/dist/transport/cooldown.js +8 -1
- package/dist/transport/delivery.d.ts +14 -6
- package/dist/transport/delivery.js +80 -55
- package/dist/transport/http-transport.d.ts +1 -0
- package/dist/transport/http-transport.js +52 -10
- package/dist/transport/index.d.ts +6 -3
- package/dist/transport/index.js +3 -0
- package/dist/transport/queue-partition.d.ts +91 -0
- package/dist/transport/queue-partition.js +143 -0
- package/dist/transport/queue.d.ts +99 -20
- package/dist/transport/queue.js +210 -69
- package/dist/transport/response-body.d.ts +25 -0
- package/dist/transport/response-body.js +64 -0
- package/dist/transport/send.d.ts +11 -0
- package/dist/transport/send.js +17 -0
- package/dist/transport/types/delivery-flow.types.d.ts +19 -0
- package/dist/transport/types/delivery-flow.types.js +1 -0
- package/dist/transport/types/transport.types.d.ts +45 -0
- package/dist/turns/claude-transcript.d.ts +19 -1
- package/dist/turns/claude-transcript.js +46 -1
- package/dist/turns/codex-originator.d.ts +11 -0
- package/dist/turns/codex-originator.js +31 -0
- package/dist/turns/codex-transcript.d.ts +30 -0
- package/dist/turns/codex-transcript.js +88 -0
- package/dist/turns/constants/turns.constants.d.ts +141 -5
- package/dist/turns/constants/turns.constants.js +155 -5
- package/dist/turns/file-identity.d.ts +27 -0
- package/dist/turns/file-identity.js +48 -0
- package/dist/turns/gemini-transcript.d.ts +30 -0
- package/dist/turns/gemini-transcript.js +96 -0
- package/dist/turns/index.d.ts +3 -3
- package/dist/turns/index.js +1 -1
- package/dist/turns/inherited-checkout.d.ts +54 -0
- package/dist/turns/inherited-checkout.js +155 -0
- package/dist/turns/native-session-titles.d.ts +26 -0
- package/dist/turns/native-session-titles.js +102 -0
- package/dist/turns/transcript.d.ts +3 -2
- package/dist/turns/transcript.js +5 -1
- package/dist/turns/turn-state.d.ts +224 -3
- package/dist/turns/turn-state.js +456 -21
- package/dist/turns/turn-summary.d.ts +1 -14
- package/dist/turns/turn-summary.js +87 -51
- package/dist/turns/turn-tracker.d.ts +21 -2
- package/dist/turns/turn-tracker.js +379 -56
- package/dist/turns/types/transcript.types.d.ts +5 -0
- package/dist/turns/types/turn-state.types.d.ts +116 -5
- package/dist/turns/types/turn-summary.types.d.ts +64 -14
- package/dist/turns/types/turn-tracker.types.d.ts +27 -1
- package/dist/turns/work-checkout.d.ts +65 -0
- package/dist/turns/work-checkout.js +666 -0
- package/dist/untraced/constants/untraced.constants.d.ts +31 -0
- package/dist/untraced/constants/untraced.constants.js +63 -0
- package/dist/untraced/untraced.d.ts +35 -0
- package/dist/untraced/untraced.js +105 -0
- package/dist/update/constants/update.constants.d.ts +18 -0
- package/dist/update/constants/update.constants.js +20 -0
- package/dist/update/update-check.d.ts +52 -0
- package/dist/update/update-check.js +113 -0
- package/docs/AUDIT_PROMPT.md +129 -0
- package/docs/DATA_HANDLING.md +648 -0
- package/docs/ENTERPRISE_DEPLOYMENT.md +179 -0
- package/docs/PERFORMANCE.md +81 -0
- package/package.json +14 -4
- package/dist/enrollment/enrollment-provider.d.ts +0 -5
- package/dist/enrollment/manual-enrollment.d.ts +0 -32
- package/dist/enrollment/manual-enrollment.js +0 -72
- package/example/README.md +0 -43
- package/example/server.mjs +0 -240
- /package/dist/{enrollment/enrollment-provider.js → config/types/destination.types.js} +0 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whether a periodic cleanup is due, claiming it when it is.
|
|
3
|
+
*
|
|
4
|
+
* Both sweeps this gates — expired session state and expired queue entries —
|
|
5
|
+
* cost a directory walk plus a `stat` per file, and both run on the coding
|
|
6
|
+
* agent's hook path, where they were paid on *every* closing turn to discover
|
|
7
|
+
* that nothing had aged out yet. The marker's own mtime is the whole clock: one
|
|
8
|
+
* `stat` on the common path.
|
|
9
|
+
*
|
|
10
|
+
* Deliberately unlocked. Two hooks can both decide a sweep is due and both run
|
|
11
|
+
* it; every removal a sweep makes is idempotent, so the cost of the race is one
|
|
12
|
+
* redundant walk and the cost of a lock would be paid on every hook.
|
|
13
|
+
*
|
|
14
|
+
* @param marker - File whose mtime records the last sweep.
|
|
15
|
+
* @param intervalMs - Minimum gap between sweeps.
|
|
16
|
+
* @param nowMs - This invocation's clock reading.
|
|
17
|
+
* @returns True when the caller should sweep now.
|
|
18
|
+
*/
|
|
19
|
+
export declare function claimSweep(marker: string, intervalMs: number, nowMs: number): Promise<boolean>;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import fs from 'node:fs/promises';
|
|
2
|
+
import { writeFileAtomic } from './atomic-file.js';
|
|
3
|
+
import { SECRET_FILE_MODE } from './constants/storage.constants.js';
|
|
4
|
+
/**
|
|
5
|
+
* Whether a periodic cleanup is due, claiming it when it is.
|
|
6
|
+
*
|
|
7
|
+
* Both sweeps this gates — expired session state and expired queue entries —
|
|
8
|
+
* cost a directory walk plus a `stat` per file, and both run on the coding
|
|
9
|
+
* agent's hook path, where they were paid on *every* closing turn to discover
|
|
10
|
+
* that nothing had aged out yet. The marker's own mtime is the whole clock: one
|
|
11
|
+
* `stat` on the common path.
|
|
12
|
+
*
|
|
13
|
+
* Deliberately unlocked. Two hooks can both decide a sweep is due and both run
|
|
14
|
+
* it; every removal a sweep makes is idempotent, so the cost of the race is one
|
|
15
|
+
* redundant walk and the cost of a lock would be paid on every hook.
|
|
16
|
+
*
|
|
17
|
+
* @param marker - File whose mtime records the last sweep.
|
|
18
|
+
* @param intervalMs - Minimum gap between sweeps.
|
|
19
|
+
* @param nowMs - This invocation's clock reading.
|
|
20
|
+
* @returns True when the caller should sweep now.
|
|
21
|
+
*/
|
|
22
|
+
export async function claimSweep(marker, intervalMs, nowMs) {
|
|
23
|
+
const last = await lastSweptMs(marker);
|
|
24
|
+
if (last !== undefined && nowMs - last < intervalMs)
|
|
25
|
+
return false;
|
|
26
|
+
try {
|
|
27
|
+
// Through the same write every other file in the state directory uses: it
|
|
28
|
+
// renames a 0600 temp file over the target, so a marker somebody
|
|
29
|
+
// pre-created as a symlink is replaced rather than followed, and the state
|
|
30
|
+
// root — which `AGENTWATCH_DATA_DIR` can point at a shared temp directory —
|
|
31
|
+
// never holds a default-mode file this package created.
|
|
32
|
+
await writeFileAtomic(marker, '', SECRET_FILE_MODE);
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
// The state directory is unwritable, which every other write will report.
|
|
37
|
+
// Sweeping anyway would then run on every hook, which is the cost this
|
|
38
|
+
// exists to remove.
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* When the last sweep finished, by the marker's mtime.
|
|
44
|
+
*
|
|
45
|
+
* @param marker - The marker file.
|
|
46
|
+
* @returns Epoch milliseconds, or undefined when nothing has swept yet.
|
|
47
|
+
*/
|
|
48
|
+
async function lastSweptMs(marker) {
|
|
49
|
+
try {
|
|
50
|
+
return (await fs.stat(marker)).mtimeMs;
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return undefined;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -16,6 +16,8 @@ export interface AgentWatchPaths {
|
|
|
16
16
|
readonly turnsDir: string;
|
|
17
17
|
/** Per-repository record of the last snapshot sent, so the next one is a diff. */
|
|
18
18
|
readonly snapshotsDir: string;
|
|
19
|
+
/** Per-checkout record of what its remote is called, so the gate asks git once. */
|
|
20
|
+
readonly checkoutsDir: string;
|
|
19
21
|
}
|
|
20
22
|
/**
|
|
21
23
|
* Outcome of a tolerant JSON read. `missing` and `invalid` are distinct on
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { AgentWatchPaths } from './types/storage.types.js';
|
|
2
|
+
/**
|
|
3
|
+
* The marker `uninstall` leaves beside config.json.
|
|
4
|
+
*
|
|
5
|
+
* Uninstall without `--purge` keeps the config, install keys included, so a
|
|
6
|
+
* reinstall needs no answers again. Without this marker the next `status`,
|
|
7
|
+
* `doctor` or header-helper run would trade a key for a fresh device credential
|
|
8
|
+
* the person had just switched off, or send the key itself. Beside the config,
|
|
9
|
+
* so `--purge` takes it with the keys.
|
|
10
|
+
*
|
|
11
|
+
* @param paths - Resolved AgentWatch paths.
|
|
12
|
+
* @returns The marker path.
|
|
13
|
+
*/
|
|
14
|
+
export declare function uninstalledFile(paths: AgentWatchPaths): string;
|
|
15
|
+
/**
|
|
16
|
+
* The marker's name for an entry of the config: the machine's, or a root's by
|
|
17
|
+
* its resolved path, as `selectRoot` names it.
|
|
18
|
+
*
|
|
19
|
+
* @param rootPath - The root, or undefined for the machine entry.
|
|
20
|
+
* @returns The scope.
|
|
21
|
+
*/
|
|
22
|
+
export declare function uninstallScope(rootPath: string | undefined): string;
|
|
23
|
+
/**
|
|
24
|
+
* Every scope a config file holds: the machine's and each absolute root's.
|
|
25
|
+
*
|
|
26
|
+
* @param roots - The config's `roots` block.
|
|
27
|
+
* @returns The scopes, machine first.
|
|
28
|
+
*/
|
|
29
|
+
export declare function configScopes(roots: Readonly<Record<string, unknown>> | undefined): readonly string[];
|
|
30
|
+
/**
|
|
31
|
+
* Whether this scope was uninstalled since its last setup. A marker that cannot
|
|
32
|
+
* be read, or names no scopes, counts for every scope: enrolling a device or
|
|
33
|
+
* sending a key by mistake is the worse error.
|
|
34
|
+
*
|
|
35
|
+
* @param paths - Resolved AgentWatch paths.
|
|
36
|
+
* @param scope - The entry asked about; the machine's when absent.
|
|
37
|
+
* @returns True while only setup may enroll or send for it.
|
|
38
|
+
*/
|
|
39
|
+
export declare function isUninstalled(paths: AgentWatchPaths, scope?: string): Promise<boolean>;
|
|
40
|
+
/**
|
|
41
|
+
* Record an uninstall, before its credentials are removed, so no run in between
|
|
42
|
+
* enrolls an install key again or sends one.
|
|
43
|
+
*
|
|
44
|
+
* @param paths - Resolved AgentWatch paths.
|
|
45
|
+
* @param scopes - The entries uninstalled; every scope when unknown (an unreadable config).
|
|
46
|
+
* @param now - When.
|
|
47
|
+
*/
|
|
48
|
+
export declare function markUninstalled(paths: AgentWatchPaths, scopes: readonly string[] | undefined, now: Date): Promise<void>;
|
|
49
|
+
/**
|
|
50
|
+
* Lift the marker for one scope: setup has just been run for it on purpose.
|
|
51
|
+
* The other scopes stay uninstalled until their own setup.
|
|
52
|
+
*
|
|
53
|
+
* @param paths - Resolved AgentWatch paths.
|
|
54
|
+
* @param scope - The entry setup ran for.
|
|
55
|
+
* @param known - Every scope the config holds, for a marker that names none.
|
|
56
|
+
* @returns The scopes still uninstalled, so setup can name them.
|
|
57
|
+
*/
|
|
58
|
+
export declare function clearUninstalled(paths: AgentWatchPaths, scope: string, known: readonly string[]): Promise<readonly string[]>;
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import fs from 'node:fs/promises';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { writeFileAtomic } from './atomic-file.js';
|
|
4
|
+
import { MACHINE_SCOPE, UNINSTALLED_FILE_NAME } from './constants/storage.constants.js';
|
|
5
|
+
import { readJsonFile } from './json-file.js';
|
|
6
|
+
/**
|
|
7
|
+
* The marker `uninstall` leaves beside config.json.
|
|
8
|
+
*
|
|
9
|
+
* Uninstall without `--purge` keeps the config, install keys included, so a
|
|
10
|
+
* reinstall needs no answers again. Without this marker the next `status`,
|
|
11
|
+
* `doctor` or header-helper run would trade a key for a fresh device credential
|
|
12
|
+
* the person had just switched off, or send the key itself. Beside the config,
|
|
13
|
+
* so `--purge` takes it with the keys.
|
|
14
|
+
*
|
|
15
|
+
* @param paths - Resolved AgentWatch paths.
|
|
16
|
+
* @returns The marker path.
|
|
17
|
+
*/
|
|
18
|
+
export function uninstalledFile(paths) {
|
|
19
|
+
return path.join(paths.configDir, UNINSTALLED_FILE_NAME);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* The marker's name for an entry of the config: the machine's, or a root's by
|
|
23
|
+
* its resolved path, as `selectRoot` names it.
|
|
24
|
+
*
|
|
25
|
+
* @param rootPath - The root, or undefined for the machine entry.
|
|
26
|
+
* @returns The scope.
|
|
27
|
+
*/
|
|
28
|
+
export function uninstallScope(rootPath) {
|
|
29
|
+
return rootPath === undefined ? MACHINE_SCOPE : path.resolve(rootPath);
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Every scope a config file holds: the machine's and each absolute root's.
|
|
33
|
+
*
|
|
34
|
+
* @param roots - The config's `roots` block.
|
|
35
|
+
* @returns The scopes, machine first.
|
|
36
|
+
*/
|
|
37
|
+
export function configScopes(roots) {
|
|
38
|
+
return [MACHINE_SCOPE, ...Object.keys(roots ?? {}).filter((key) => path.isAbsolute(key)).map(uninstallScope)];
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Whether this scope was uninstalled since its last setup. A marker that cannot
|
|
42
|
+
* be read, or names no scopes, counts for every scope: enrolling a device or
|
|
43
|
+
* sending a key by mistake is the worse error.
|
|
44
|
+
*
|
|
45
|
+
* @param paths - Resolved AgentWatch paths.
|
|
46
|
+
* @param scope - The entry asked about; the machine's when absent.
|
|
47
|
+
* @returns True while only setup may enroll or send for it.
|
|
48
|
+
*/
|
|
49
|
+
export async function isUninstalled(paths, scope = MACHINE_SCOPE) {
|
|
50
|
+
const scopes = await markedScopes(paths);
|
|
51
|
+
return scopes === 'all' || (scopes?.includes(scope) ?? false);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Record an uninstall, before its credentials are removed, so no run in between
|
|
55
|
+
* enrolls an install key again or sends one.
|
|
56
|
+
*
|
|
57
|
+
* @param paths - Resolved AgentWatch paths.
|
|
58
|
+
* @param scopes - The entries uninstalled; every scope when unknown (an unreadable config).
|
|
59
|
+
* @param now - When.
|
|
60
|
+
*/
|
|
61
|
+
export async function markUninstalled(paths, scopes, now) {
|
|
62
|
+
await fs.mkdir(paths.configDir, { recursive: true });
|
|
63
|
+
await writeFileAtomic(uninstalledFile(paths), JSON.stringify({ uninstalledAt: now.toISOString(), ...(scopes ? { scopes } : {}) }) + '\n');
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Lift the marker for one scope: setup has just been run for it on purpose.
|
|
67
|
+
* The other scopes stay uninstalled until their own setup.
|
|
68
|
+
*
|
|
69
|
+
* @param paths - Resolved AgentWatch paths.
|
|
70
|
+
* @param scope - The entry setup ran for.
|
|
71
|
+
* @param known - Every scope the config holds, for a marker that names none.
|
|
72
|
+
* @returns The scopes still uninstalled, so setup can name them.
|
|
73
|
+
*/
|
|
74
|
+
export async function clearUninstalled(paths, scope, known) {
|
|
75
|
+
const scopes = await markedScopes(paths);
|
|
76
|
+
if (scopes === undefined)
|
|
77
|
+
return [];
|
|
78
|
+
const remaining = (scopes === 'all' ? known : scopes).filter((marked) => marked !== scope);
|
|
79
|
+
if (remaining.length === 0) {
|
|
80
|
+
await fs.rm(uninstalledFile(paths), { force: true });
|
|
81
|
+
return [];
|
|
82
|
+
}
|
|
83
|
+
const read = await readJsonFile(uninstalledFile(paths));
|
|
84
|
+
const at = read.state === 'ok' && typeof read.value.uninstalledAt === 'string' ? read.value.uninstalledAt : undefined;
|
|
85
|
+
await writeFileAtomic(uninstalledFile(paths), JSON.stringify({ ...(at ? { uninstalledAt: at } : {}), scopes: remaining }) + '\n');
|
|
86
|
+
return remaining;
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* The scopes the marker names: undefined without a marker, `all` for one that
|
|
90
|
+
* names none or cannot be read.
|
|
91
|
+
*
|
|
92
|
+
* @param paths - Resolved AgentWatch paths.
|
|
93
|
+
* @returns The marked scopes.
|
|
94
|
+
*/
|
|
95
|
+
async function markedScopes(paths) {
|
|
96
|
+
try {
|
|
97
|
+
await fs.lstat(uninstalledFile(paths));
|
|
98
|
+
}
|
|
99
|
+
catch (error) {
|
|
100
|
+
return error.code === 'ENOENT' ? undefined : 'all';
|
|
101
|
+
}
|
|
102
|
+
const read = await readJsonFile(uninstalledFile(paths));
|
|
103
|
+
const scopes = read.state === 'ok' ? read.value?.scopes : undefined;
|
|
104
|
+
if (!Array.isArray(scopes) || !scopes.every((scope) => typeof scope === 'string'))
|
|
105
|
+
return 'all';
|
|
106
|
+
return scopes;
|
|
107
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { AuthBlockState } from './types/transport.types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Persisted "this credential is rejected" flag for one identity.
|
|
4
|
+
*
|
|
5
|
+
* The state file lives in the identity's own state directory, whose name is
|
|
6
|
+
* already the token digest, so the block is keyed by
|
|
7
|
+
* `(destination, credential fingerprint)` without ever storing the token: a new
|
|
8
|
+
* token lands in a different directory and a new endpoint fails the destination
|
|
9
|
+
* check, which is exactly the "a change of fingerprint lifts the block" rule.
|
|
10
|
+
*
|
|
11
|
+
* It does **not** expire on a timer: it stands, and `status` reports it, until
|
|
12
|
+
* the backend accepts the credential. What it stops is the *retrying*, and only
|
|
13
|
+
* for {@link AUTH_BLOCK_REPROBE_MS} after each refusal — then one send asks
|
|
14
|
+
* again, because a token can become good again without changing on the machine
|
|
15
|
+
* (a token row restored server-side, a revocation undone). The records
|
|
16
|
+
* themselves stay queued, unconditionally.
|
|
17
|
+
*/
|
|
18
|
+
export declare class BackendAuthBlock {
|
|
19
|
+
private readonly file;
|
|
20
|
+
private readonly now;
|
|
21
|
+
/**
|
|
22
|
+
* Bind the block to its state file.
|
|
23
|
+
*
|
|
24
|
+
* @param file - Where the block is persisted.
|
|
25
|
+
* @param now - Clock, injectable for tests.
|
|
26
|
+
*/
|
|
27
|
+
constructor(file: string, now?: () => Date);
|
|
28
|
+
/**
|
|
29
|
+
* The block standing against one destination, if any.
|
|
30
|
+
*
|
|
31
|
+
* @param destination - The events URL this invocation would send to.
|
|
32
|
+
* @returns The block, or undefined when sends may proceed.
|
|
33
|
+
*/
|
|
34
|
+
active(destination: string): Promise<AuthBlockState | undefined>;
|
|
35
|
+
/**
|
|
36
|
+
* Whether the block still suspends sends to a destination: it stands and its
|
|
37
|
+
* last refusal is younger than the re-probe interval.
|
|
38
|
+
*
|
|
39
|
+
* @param destination - The events URL this invocation would send to.
|
|
40
|
+
* @returns True while sends must wait.
|
|
41
|
+
*/
|
|
42
|
+
holds(destination: string): Promise<boolean>;
|
|
43
|
+
/**
|
|
44
|
+
* Record that this destination refused the credential.
|
|
45
|
+
*
|
|
46
|
+
* A block already standing for the same destination keeps its original
|
|
47
|
+
* `since`: an administrator needs to know when the refusals started, not when
|
|
48
|
+
* the last hook ran. `lastRefusalAt` moves, and restarts the re-probe wait.
|
|
49
|
+
*
|
|
50
|
+
* @param destination - The events URL that refused.
|
|
51
|
+
* @param status - The refusing HTTP status.
|
|
52
|
+
* @param reason - The gateway's reason, when it gave one the edge acts on
|
|
53
|
+
* (`token_expired` makes the next run refresh at once).
|
|
54
|
+
*/
|
|
55
|
+
raise(destination: string, status: number, reason?: string): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* Lift the block — the backend accepted the credential.
|
|
58
|
+
*/
|
|
59
|
+
clear(): Promise<void>;
|
|
60
|
+
/**
|
|
61
|
+
* The persisted block, whatever destination it names.
|
|
62
|
+
*
|
|
63
|
+
* @returns The block, or undefined when there is none to read.
|
|
64
|
+
*/
|
|
65
|
+
private read;
|
|
66
|
+
}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
import fs from 'node:fs/promises';
|
|
2
|
+
import { asRecord } from '../core/object.js';
|
|
3
|
+
import { writeFileAtomic } from '../storage/atomic-file.js';
|
|
4
|
+
import { SECRET_FILE_MODE } from '../storage/constants/storage.constants.js';
|
|
5
|
+
import { AUTH_BLOCK_REPROBE_MS } from './constants/transport.constants.js';
|
|
6
|
+
/**
|
|
7
|
+
* Persisted "this credential is rejected" flag for one identity.
|
|
8
|
+
*
|
|
9
|
+
* The state file lives in the identity's own state directory, whose name is
|
|
10
|
+
* already the token digest, so the block is keyed by
|
|
11
|
+
* `(destination, credential fingerprint)` without ever storing the token: a new
|
|
12
|
+
* token lands in a different directory and a new endpoint fails the destination
|
|
13
|
+
* check, which is exactly the "a change of fingerprint lifts the block" rule.
|
|
14
|
+
*
|
|
15
|
+
* It does **not** expire on a timer: it stands, and `status` reports it, until
|
|
16
|
+
* the backend accepts the credential. What it stops is the *retrying*, and only
|
|
17
|
+
* for {@link AUTH_BLOCK_REPROBE_MS} after each refusal — then one send asks
|
|
18
|
+
* again, because a token can become good again without changing on the machine
|
|
19
|
+
* (a token row restored server-side, a revocation undone). The records
|
|
20
|
+
* themselves stay queued, unconditionally.
|
|
21
|
+
*/
|
|
22
|
+
export class BackendAuthBlock {
|
|
23
|
+
file;
|
|
24
|
+
now;
|
|
25
|
+
/**
|
|
26
|
+
* Bind the block to its state file.
|
|
27
|
+
*
|
|
28
|
+
* @param file - Where the block is persisted.
|
|
29
|
+
* @param now - Clock, injectable for tests.
|
|
30
|
+
*/
|
|
31
|
+
constructor(file, now = () => new Date()) {
|
|
32
|
+
this.file = file;
|
|
33
|
+
this.now = now;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* The block standing against one destination, if any.
|
|
37
|
+
*
|
|
38
|
+
* @param destination - The events URL this invocation would send to.
|
|
39
|
+
* @returns The block, or undefined when sends may proceed.
|
|
40
|
+
*/
|
|
41
|
+
async active(destination) {
|
|
42
|
+
const block = await this.read();
|
|
43
|
+
if (!block || block.destination !== destination)
|
|
44
|
+
return undefined;
|
|
45
|
+
return block;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Whether the block still suspends sends to a destination: it stands and its
|
|
49
|
+
* last refusal is younger than the re-probe interval.
|
|
50
|
+
*
|
|
51
|
+
* @param destination - The events URL this invocation would send to.
|
|
52
|
+
* @returns True while sends must wait.
|
|
53
|
+
*/
|
|
54
|
+
async holds(destination) {
|
|
55
|
+
const block = await this.active(destination);
|
|
56
|
+
if (!block)
|
|
57
|
+
return false;
|
|
58
|
+
return this.now().getTime() - Date.parse(block.lastRefusalAt ?? block.since) < AUTH_BLOCK_REPROBE_MS;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Record that this destination refused the credential.
|
|
62
|
+
*
|
|
63
|
+
* A block already standing for the same destination keeps its original
|
|
64
|
+
* `since`: an administrator needs to know when the refusals started, not when
|
|
65
|
+
* the last hook ran. `lastRefusalAt` moves, and restarts the re-probe wait.
|
|
66
|
+
*
|
|
67
|
+
* @param destination - The events URL that refused.
|
|
68
|
+
* @param status - The refusing HTTP status.
|
|
69
|
+
* @param reason - The gateway's reason, when it gave one the edge acts on
|
|
70
|
+
* (`token_expired` makes the next run refresh at once).
|
|
71
|
+
*/
|
|
72
|
+
async raise(destination, status, reason) {
|
|
73
|
+
const standing = await this.active(destination);
|
|
74
|
+
const block = {
|
|
75
|
+
destination,
|
|
76
|
+
status,
|
|
77
|
+
since: standing?.since ?? this.now().toISOString(),
|
|
78
|
+
lastRefusalAt: this.now().toISOString(),
|
|
79
|
+
...(reason ? { reason } : {})
|
|
80
|
+
};
|
|
81
|
+
try {
|
|
82
|
+
await writeFileAtomic(this.file, JSON.stringify(block), SECRET_FILE_MODE);
|
|
83
|
+
}
|
|
84
|
+
catch {
|
|
85
|
+
// Same rule as the cooldown: this runs on the hook path, and failing to
|
|
86
|
+
// persist a diagnosis must never fail the agent's turn.
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Lift the block — the backend accepted the credential.
|
|
91
|
+
*/
|
|
92
|
+
async clear() {
|
|
93
|
+
try {
|
|
94
|
+
await fs.rm(this.file, { force: true });
|
|
95
|
+
}
|
|
96
|
+
catch {
|
|
97
|
+
// Awaited between a proven-good credential and the drain: a failure to
|
|
98
|
+
// remove the file must not abort the pass that would empty the backlog.
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* The persisted block, whatever destination it names.
|
|
103
|
+
*
|
|
104
|
+
* @returns The block, or undefined when there is none to read.
|
|
105
|
+
*/
|
|
106
|
+
async read() {
|
|
107
|
+
try {
|
|
108
|
+
const raw = asRecord(JSON.parse(await fs.readFile(this.file, 'utf8')));
|
|
109
|
+
if (typeof raw?.['destination'] !== 'string' || typeof raw['status'] !== 'number' || typeof raw['since'] !== 'string')
|
|
110
|
+
return undefined;
|
|
111
|
+
// A block written before re-probing existed has no lastRefusalAt; `since`
|
|
112
|
+
// stands in for it, so an old block is probed on the next hook.
|
|
113
|
+
const lastRefusalAt = typeof raw['lastRefusalAt'] === 'string' ? raw['lastRefusalAt'] : undefined;
|
|
114
|
+
return {
|
|
115
|
+
destination: raw['destination'],
|
|
116
|
+
status: raw['status'],
|
|
117
|
+
since: raw['since'],
|
|
118
|
+
lastRefusalAt,
|
|
119
|
+
...(typeof raw['reason'] === 'string' ? { reason: raw['reason'] } : {})
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
// No file, or one we cannot read: assume the credential is good. Failing
|
|
124
|
+
// open costs one refused send; failing closed would silence telemetry on
|
|
125
|
+
// an install that is working.
|
|
126
|
+
return undefined;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
* entries without a destination have the same pre-setup behavior.
|
|
5
5
|
*/
|
|
6
6
|
export declare const ANY_DESTINATION = "*";
|
|
7
|
+
/** Avoid starting a drain/probe with an unusable remainder of the hook budget. */
|
|
8
|
+
export declare const MIN_VIABLE_SEND_MS = 10;
|
|
7
9
|
/** How long hooks skip direct sends after the backend failed one. */
|
|
8
10
|
export declare const BACKEND_COOLDOWN_MS = 60000;
|
|
9
11
|
/**
|
|
@@ -23,16 +25,48 @@ export declare const BACKOFF_JITTER_RANGE = 0.5;
|
|
|
23
25
|
/** Lock names serializing the two multi-process operations. */
|
|
24
26
|
export declare const QUEUE_DRAIN_LOCK = "queue-drain";
|
|
25
27
|
export declare const DELIVERY_STATS_LOCK = "delivery-stats";
|
|
26
|
-
/** Bounded wait for the drain lock when setup re-routes the backlog. */
|
|
27
|
-
export declare const RETARGET_LOCK_WAIT_MS = 10000;
|
|
28
|
-
export declare const RETARGET_LOCK_POLL_MS = 50;
|
|
29
28
|
/** Bounded: recordRejected runs on the hook path and must never stall it. */
|
|
30
29
|
export declare const STATS_LOCK_MAX_WAIT_MS = 300;
|
|
31
30
|
export declare const STATS_LOCK_POLL_MS = 25;
|
|
32
31
|
/** HTTP statuses worth retrying that are not 5xx. */
|
|
33
32
|
export declare const RETRYABLE_STATUSES: ReadonlySet<number>;
|
|
33
|
+
/**
|
|
34
|
+
* The backend refusing the credential itself.
|
|
35
|
+
*
|
|
36
|
+
* Deliberately *not* retryable: a revoked or rotated token does not become
|
|
37
|
+
* valid by waiting, and re-presenting it on every hook for a week reads to the
|
|
38
|
+
* backend's security monitoring as low-rate credential stuffing from every
|
|
39
|
+
* developer machine at once — and to the operator as nothing at all. The
|
|
40
|
+
* records stay queued; what stops is the retrying.
|
|
41
|
+
*/
|
|
42
|
+
export declare const AUTH_REJECTED_STATUSES: ReadonlySet<number>;
|
|
43
|
+
/**
|
|
44
|
+
* How long a refused credential stays suspended before one hook asks again.
|
|
45
|
+
*
|
|
46
|
+
* A refusal is not always permanent: a token row restored on the server, a
|
|
47
|
+
* revocation undone or a backend that briefly answered 401 all make the same
|
|
48
|
+
* token good again, and the token never changes on the machine. With no
|
|
49
|
+
* re-probe the edge then held every turn until someone ran `agentwatch status`
|
|
50
|
+
* by hand, and dropped what passed the age bound. One request per interval per
|
|
51
|
+
* machine is far from the per-hook retrying that reads as credential stuffing.
|
|
52
|
+
*
|
|
53
|
+
* ponytail: fixed interval; switch to exponential backoff if refused-token
|
|
54
|
+
* traffic ever shows up in gateway monitoring.
|
|
55
|
+
*/
|
|
56
|
+
export declare const AUTH_BLOCK_REPROBE_MS: number;
|
|
57
|
+
/**
|
|
58
|
+
* Ceiling on a response body the hook will decode.
|
|
59
|
+
*
|
|
60
|
+
* Generous: every body the edge reads back is a handful of integers. It exists
|
|
61
|
+
* so an endpoint cannot make the coding agent's hook allocate an arbitrarily
|
|
62
|
+
* large buffer — the request timeout bounds the request, not the decode.
|
|
63
|
+
*/
|
|
64
|
+
export declare const MAX_RESPONSE_BYTES: number;
|
|
65
|
+
/** Reason a body was refused; never carries any of the body itself. */
|
|
66
|
+
export declare const BODY_TOO_LARGE = "response body too large";
|
|
34
67
|
/** Request headers every batch carries. */
|
|
35
68
|
export declare const CONTENT_TYPE_HEADER = "content-type";
|
|
69
|
+
export declare const CONTENT_LENGTH_HEADER = "content-length";
|
|
36
70
|
export declare const USER_AGENT_HEADER = "user-agent";
|
|
37
71
|
export declare const AUTHORIZATION_HEADER = "authorization";
|
|
38
72
|
export declare const INSTALLATION_HEADER = "x-agentwatch-installation";
|
|
@@ -41,7 +75,52 @@ export declare const USER_AGENT = "agentwatch-edge";
|
|
|
41
75
|
/** Filenames under the data directory. */
|
|
42
76
|
export declare const COOLDOWN_FILE_NAME = "backend-cooldown.json";
|
|
43
77
|
export declare const DELIVERY_STATS_FILE_NAME = "delivery-stats.json";
|
|
78
|
+
export declare const AUTH_BLOCK_FILE_NAME = "auth-block.json";
|
|
44
79
|
export declare const MS_PER_DAY: number;
|
|
45
80
|
/** Characters unsafe in a queue filename. */
|
|
46
81
|
export declare const RE_UNSAFE_QUEUE_NAME: RegExp;
|
|
47
82
|
export declare const QUEUE_FILE_SUFFIX = ".json";
|
|
83
|
+
/**
|
|
84
|
+
* Where a bounded scan stopped, so the next one resumes instead of re-reading
|
|
85
|
+
* the same head. Deliberately not a `.json` name: the entry listing filters on
|
|
86
|
+
* that suffix, so the cursor is invisible to every count and every sweep.
|
|
87
|
+
*/
|
|
88
|
+
export declare const QUEUE_SCAN_CURSOR_FILE = ".scan";
|
|
89
|
+
/**
|
|
90
|
+
* How often a drain may walk the whole partition to enforce the retention
|
|
91
|
+
* bound, rather than only the batch-sized head of it.
|
|
92
|
+
*/
|
|
93
|
+
export declare const QUEUE_SWEEP_INTERVAL_MS: number;
|
|
94
|
+
/**
|
|
95
|
+
* Queue partition used before setup writes a token. Entries land here pinned to
|
|
96
|
+
* ANY_DESTINATION, and the first identity setup configures adopts them — which
|
|
97
|
+
* is the same promise ANY_DESTINATION already makes.
|
|
98
|
+
*/
|
|
99
|
+
export declare const UNCONFIGURED_PARTITION = "unconfigured";
|
|
100
|
+
/**
|
|
101
|
+
* Queue partition for a backlog written before the queue was partitioned, on a
|
|
102
|
+
* machine that already serves more than one identity. Nothing drains it: those
|
|
103
|
+
* entries record no identity, and guessing one is precisely how one tenant's
|
|
104
|
+
* usage lands in another tenant's ledger.
|
|
105
|
+
*/
|
|
106
|
+
export declare const UNATTRIBUTED_PARTITION = "unattributed";
|
|
107
|
+
/**
|
|
108
|
+
* Hex characters of the token digest that names a partition. 48 bits is far
|
|
109
|
+
* more than the handful of identities one machine holds, and a digest rather
|
|
110
|
+
* than the token itself keeps the bearer out of every `ls`, backup and crash
|
|
111
|
+
* dump that ever touches the data directory.
|
|
112
|
+
*/
|
|
113
|
+
export declare const IDENTITY_FINGERPRINT_CHARS = 12;
|
|
114
|
+
/** Under the data directory: one sub-directory per identity for cooldown and loss stats. */
|
|
115
|
+
export declare const IDENTITY_STATE_DIR_NAME = "identity";
|
|
116
|
+
/** Delivery order makes persistence precede optional diagnostic writes. */
|
|
117
|
+
export declare const DELIVERY_STAGE_NAMES: {
|
|
118
|
+
readonly select: "select-delivery";
|
|
119
|
+
readonly send: "send-current";
|
|
120
|
+
readonly preserve: "preserve-unsent";
|
|
121
|
+
readonly report: "report-backend";
|
|
122
|
+
readonly maintain: "maintain-queue";
|
|
123
|
+
};
|
|
124
|
+
/** In an identity's state directory: its cached access token and its device credential state (AWT-356). */
|
|
125
|
+
export declare const ACCESS_TOKEN_FILE_NAME = "access-token.json";
|
|
126
|
+
export declare const DEVICE_STATE_FILE_NAME = "device.json";
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
* entries without a destination have the same pre-setup behavior.
|
|
5
5
|
*/
|
|
6
6
|
export const ANY_DESTINATION = '*';
|
|
7
|
+
/** Avoid starting a drain/probe with an unusable remainder of the hook budget. */
|
|
8
|
+
export const MIN_VIABLE_SEND_MS = 10;
|
|
7
9
|
/** How long hooks skip direct sends after the backend failed one. */
|
|
8
10
|
export const BACKEND_COOLDOWN_MS = 60_000;
|
|
9
11
|
/**
|
|
@@ -23,16 +25,48 @@ export const BACKOFF_JITTER_RANGE = 0.5;
|
|
|
23
25
|
/** Lock names serializing the two multi-process operations. */
|
|
24
26
|
export const QUEUE_DRAIN_LOCK = 'queue-drain';
|
|
25
27
|
export const DELIVERY_STATS_LOCK = 'delivery-stats';
|
|
26
|
-
/** Bounded wait for the drain lock when setup re-routes the backlog. */
|
|
27
|
-
export const RETARGET_LOCK_WAIT_MS = 10_000;
|
|
28
|
-
export const RETARGET_LOCK_POLL_MS = 50;
|
|
29
28
|
/** Bounded: recordRejected runs on the hook path and must never stall it. */
|
|
30
29
|
export const STATS_LOCK_MAX_WAIT_MS = 300;
|
|
31
30
|
export const STATS_LOCK_POLL_MS = 25;
|
|
32
31
|
/** HTTP statuses worth retrying that are not 5xx. */
|
|
33
|
-
export const RETRYABLE_STATUSES = new Set([
|
|
32
|
+
export const RETRYABLE_STATUSES = new Set([408, 429]);
|
|
33
|
+
/**
|
|
34
|
+
* The backend refusing the credential itself.
|
|
35
|
+
*
|
|
36
|
+
* Deliberately *not* retryable: a revoked or rotated token does not become
|
|
37
|
+
* valid by waiting, and re-presenting it on every hook for a week reads to the
|
|
38
|
+
* backend's security monitoring as low-rate credential stuffing from every
|
|
39
|
+
* developer machine at once — and to the operator as nothing at all. The
|
|
40
|
+
* records stay queued; what stops is the retrying.
|
|
41
|
+
*/
|
|
42
|
+
export const AUTH_REJECTED_STATUSES = new Set([401, 403]);
|
|
43
|
+
/**
|
|
44
|
+
* How long a refused credential stays suspended before one hook asks again.
|
|
45
|
+
*
|
|
46
|
+
* A refusal is not always permanent: a token row restored on the server, a
|
|
47
|
+
* revocation undone or a backend that briefly answered 401 all make the same
|
|
48
|
+
* token good again, and the token never changes on the machine. With no
|
|
49
|
+
* re-probe the edge then held every turn until someone ran `agentwatch status`
|
|
50
|
+
* by hand, and dropped what passed the age bound. One request per interval per
|
|
51
|
+
* machine is far from the per-hook retrying that reads as credential stuffing.
|
|
52
|
+
*
|
|
53
|
+
* ponytail: fixed interval; switch to exponential backoff if refused-token
|
|
54
|
+
* traffic ever shows up in gateway monitoring.
|
|
55
|
+
*/
|
|
56
|
+
export const AUTH_BLOCK_REPROBE_MS = 15 * 60_000;
|
|
57
|
+
/**
|
|
58
|
+
* Ceiling on a response body the hook will decode.
|
|
59
|
+
*
|
|
60
|
+
* Generous: every body the edge reads back is a handful of integers. It exists
|
|
61
|
+
* so an endpoint cannot make the coding agent's hook allocate an arbitrarily
|
|
62
|
+
* large buffer — the request timeout bounds the request, not the decode.
|
|
63
|
+
*/
|
|
64
|
+
export const MAX_RESPONSE_BYTES = 64 * 1024;
|
|
65
|
+
/** Reason a body was refused; never carries any of the body itself. */
|
|
66
|
+
export const BODY_TOO_LARGE = 'response body too large';
|
|
34
67
|
/** Request headers every batch carries. */
|
|
35
68
|
export const CONTENT_TYPE_HEADER = 'content-type';
|
|
69
|
+
export const CONTENT_LENGTH_HEADER = 'content-length';
|
|
36
70
|
export const USER_AGENT_HEADER = 'user-agent';
|
|
37
71
|
export const AUTHORIZATION_HEADER = 'authorization';
|
|
38
72
|
export const INSTALLATION_HEADER = 'x-agentwatch-installation';
|
|
@@ -41,7 +75,52 @@ export const USER_AGENT = 'agentwatch-edge';
|
|
|
41
75
|
/** Filenames under the data directory. */
|
|
42
76
|
export const COOLDOWN_FILE_NAME = 'backend-cooldown.json';
|
|
43
77
|
export const DELIVERY_STATS_FILE_NAME = 'delivery-stats.json';
|
|
78
|
+
export const AUTH_BLOCK_FILE_NAME = 'auth-block.json';
|
|
44
79
|
export const MS_PER_DAY = 24 * 60 * 60 * 1000;
|
|
45
80
|
/** Characters unsafe in a queue filename. */
|
|
46
81
|
export const RE_UNSAFE_QUEUE_NAME = /[^A-Za-z0-9_-]/g;
|
|
47
82
|
export const QUEUE_FILE_SUFFIX = '.json';
|
|
83
|
+
/**
|
|
84
|
+
* Where a bounded scan stopped, so the next one resumes instead of re-reading
|
|
85
|
+
* the same head. Deliberately not a `.json` name: the entry listing filters on
|
|
86
|
+
* that suffix, so the cursor is invisible to every count and every sweep.
|
|
87
|
+
*/
|
|
88
|
+
export const QUEUE_SCAN_CURSOR_FILE = '.scan';
|
|
89
|
+
/**
|
|
90
|
+
* How often a drain may walk the whole partition to enforce the retention
|
|
91
|
+
* bound, rather than only the batch-sized head of it.
|
|
92
|
+
*/
|
|
93
|
+
export const QUEUE_SWEEP_INTERVAL_MS = 60 * 60 * 1000;
|
|
94
|
+
/**
|
|
95
|
+
* Queue partition used before setup writes a token. Entries land here pinned to
|
|
96
|
+
* ANY_DESTINATION, and the first identity setup configures adopts them — which
|
|
97
|
+
* is the same promise ANY_DESTINATION already makes.
|
|
98
|
+
*/
|
|
99
|
+
export const UNCONFIGURED_PARTITION = 'unconfigured';
|
|
100
|
+
/**
|
|
101
|
+
* Queue partition for a backlog written before the queue was partitioned, on a
|
|
102
|
+
* machine that already serves more than one identity. Nothing drains it: those
|
|
103
|
+
* entries record no identity, and guessing one is precisely how one tenant's
|
|
104
|
+
* usage lands in another tenant's ledger.
|
|
105
|
+
*/
|
|
106
|
+
export const UNATTRIBUTED_PARTITION = 'unattributed';
|
|
107
|
+
/**
|
|
108
|
+
* Hex characters of the token digest that names a partition. 48 bits is far
|
|
109
|
+
* more than the handful of identities one machine holds, and a digest rather
|
|
110
|
+
* than the token itself keeps the bearer out of every `ls`, backup and crash
|
|
111
|
+
* dump that ever touches the data directory.
|
|
112
|
+
*/
|
|
113
|
+
export const IDENTITY_FINGERPRINT_CHARS = 12;
|
|
114
|
+
/** Under the data directory: one sub-directory per identity for cooldown and loss stats. */
|
|
115
|
+
export const IDENTITY_STATE_DIR_NAME = 'identity';
|
|
116
|
+
/** Delivery order makes persistence precede optional diagnostic writes. */
|
|
117
|
+
export const DELIVERY_STAGE_NAMES = {
|
|
118
|
+
select: 'select-delivery',
|
|
119
|
+
send: 'send-current',
|
|
120
|
+
preserve: 'preserve-unsent',
|
|
121
|
+
report: 'report-backend',
|
|
122
|
+
maintain: 'maintain-queue'
|
|
123
|
+
};
|
|
124
|
+
/** In an identity's state directory: its cached access token and its device credential state (AWT-356). */
|
|
125
|
+
export const ACCESS_TOKEN_FILE_NAME = 'access-token.json';
|
|
126
|
+
export const DEVICE_STATE_FILE_NAME = 'device.json';
|