@agent-watch-ai/edge 0.2.5
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 +251 -0
- package/LICENSE +21 -0
- package/README.md +168 -0
- package/dist/billing/billing-mode.d.ts +16 -0
- package/dist/billing/billing-mode.js +139 -0
- package/dist/billing/constants/billing.constants.d.ts +37 -0
- package/dist/billing/constants/billing.constants.js +38 -0
- package/dist/billing/index.d.ts +6 -0
- package/dist/billing/index.js +6 -0
- package/dist/cli/args.d.ts +29 -0
- package/dist/cli/args.js +61 -0
- package/dist/cli/constants/cli.constants.d.ts +60 -0
- package/dist/cli/constants/cli.constants.js +60 -0
- package/dist/cli/context.d.ts +51 -0
- package/dist/cli/context.js +108 -0
- package/dist/cli/doctor.d.ts +15 -0
- package/dist/cli/doctor.js +416 -0
- package/dist/cli/hook.d.ts +20 -0
- package/dist/cli/hook.js +166 -0
- package/dist/cli/index.d.ts +13 -0
- package/dist/cli/index.js +8 -0
- package/dist/cli/misc.d.ts +31 -0
- package/dist/cli/misc.js +63 -0
- package/dist/cli/setup.d.ts +32 -0
- package/dist/cli/setup.js +298 -0
- package/dist/cli/status.d.ts +11 -0
- package/dist/cli/status.js +174 -0
- package/dist/cli/types/cli.types.d.ts +69 -0
- package/dist/cli/types/cli.types.js +1 -0
- package/dist/cli/ui.d.ts +41 -0
- package/dist/cli/ui.js +78 -0
- package/dist/cli/uninstall.d.ts +13 -0
- package/dist/cli/uninstall.js +83 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +124 -0
- package/dist/config/config-store.d.ts +29 -0
- package/dist/config/config-store.js +75 -0
- package/dist/config/config.d.ts +73 -0
- package/dist/config/config.js +115 -0
- package/dist/config/constants/config.constants.d.ts +62 -0
- package/dist/config/constants/config.constants.js +70 -0
- package/dist/config/index.d.ts +10 -0
- package/dist/config/index.js +5 -0
- package/dist/config/repo-config.d.ts +37 -0
- package/dist/config/repo-config.js +178 -0
- package/dist/config/schemas/config.schema.d.ts +409 -0
- package/dist/config/schemas/config.schema.js +97 -0
- package/dist/config/types/config.types.d.ts +33 -0
- package/dist/config/types/config.types.js +1 -0
- package/dist/core/async.d.ts +20 -0
- package/dist/core/async.js +32 -0
- package/dist/core/constants/core.constants.d.ts +18 -0
- package/dist/core/constants/core.constants.js +18 -0
- package/dist/core/env.d.ts +12 -0
- package/dist/core/env.js +20 -0
- package/dist/core/index.d.ts +13 -0
- package/dist/core/index.js +8 -0
- package/dist/core/logger.d.ts +27 -0
- package/dist/core/logger.js +82 -0
- package/dist/core/number.d.ts +33 -0
- package/dist/core/number.js +47 -0
- package/dist/core/object.d.ts +78 -0
- package/dist/core/object.js +127 -0
- package/dist/core/pipe.d.ts +55 -0
- package/dist/core/pipe.js +81 -0
- package/dist/core/types/core.types.d.ts +54 -0
- package/dist/core/types/core.types.js +4 -0
- package/dist/core/version.d.ts +19 -0
- package/dist/core/version.js +35 -0
- package/dist/core/which.d.ts +13 -0
- package/dist/core/which.js +57 -0
- package/dist/enforcement/constants/enforcement.constants.d.ts +23 -0
- package/dist/enforcement/constants/enforcement.constants.js +22 -0
- package/dist/enforcement/decision-cache.d.ts +57 -0
- package/dist/enforcement/decision-cache.js +138 -0
- package/dist/enforcement/decision-client.d.ts +14 -0
- package/dist/enforcement/decision-client.js +84 -0
- package/dist/enforcement/enforcement.d.ts +17 -0
- package/dist/enforcement/enforcement.js +90 -0
- package/dist/enforcement/index.d.ts +11 -0
- package/dist/enforcement/index.js +10 -0
- package/dist/enforcement/schemas/enforcement.schema.d.ts +30 -0
- package/dist/enforcement/schemas/enforcement.schema.js +36 -0
- package/dist/enforcement/types/enforcement.types.d.ts +59 -0
- package/dist/enforcement/types/enforcement.types.js +1 -0
- package/dist/enrollment/constants/enrollment.constants.d.ts +6 -0
- package/dist/enrollment/constants/enrollment.constants.js +6 -0
- package/dist/enrollment/enrollment-provider.d.ts +5 -0
- package/dist/enrollment/enrollment-provider.js +1 -0
- package/dist/enrollment/index.d.ts +7 -0
- package/dist/enrollment/index.js +1 -0
- package/dist/enrollment/manual-enrollment.d.ts +32 -0
- package/dist/enrollment/manual-enrollment.js +72 -0
- package/dist/enrollment/types/enrollment.types.d.ts +25 -0
- package/dist/enrollment/types/enrollment.types.js +1 -0
- package/dist/events/canonical-event.d.ts +10 -0
- package/dist/events/canonical-event.js +9 -0
- package/dist/events/constants/enrich.constants.d.ts +14 -0
- package/dist/events/constants/enrich.constants.js +15 -0
- package/dist/events/constants/events.constants.d.ts +35 -0
- package/dist/events/constants/events.constants.js +57 -0
- package/dist/events/enrich.d.ts +16 -0
- package/dist/events/enrich.js +226 -0
- package/dist/events/event-id.d.ts +32 -0
- package/dist/events/event-id.js +49 -0
- package/dist/events/index.d.ts +14 -0
- package/dist/events/index.js +5 -0
- package/dist/events/llm-call.d.ts +14 -0
- package/dist/events/llm-call.js +84 -0
- package/dist/events/product-event.d.ts +39 -0
- package/dist/events/product-event.js +19 -0
- package/dist/events/types/enrich.types.d.ts +25 -0
- package/dist/events/types/enrich.types.js +1 -0
- package/dist/events/types/events.types.d.ts +112 -0
- package/dist/events/types/events.types.js +1 -0
- package/dist/events/types/llm-call.types.d.ts +79 -0
- package/dist/events/types/llm-call.types.js +1 -0
- package/dist/events/types/repo-snapshot.types.d.ts +32 -0
- package/dist/events/types/repo-snapshot.types.js +1 -0
- package/dist/feature/constants/feature.constants.d.ts +10 -0
- package/dist/feature/constants/feature.constants.js +10 -0
- package/dist/feature/index.d.ts +6 -0
- package/dist/feature/index.js +6 -0
- package/dist/feature/ticket-candidates.d.ts +13 -0
- package/dist/feature/ticket-candidates.js +26 -0
- package/dist/git/constants/git.constants.d.ts +84 -0
- package/dist/git/constants/git.constants.js +113 -0
- package/dist/git/git-context.d.ts +52 -0
- package/dist/git/git-context.js +226 -0
- package/dist/git/index.d.ts +9 -0
- package/dist/git/index.js +3 -0
- package/dist/git/remote-sanitize.d.ts +26 -0
- package/dist/git/remote-sanitize.js +92 -0
- package/dist/git/repo-snapshot.d.ts +40 -0
- package/dist/git/repo-snapshot.js +95 -0
- package/dist/git/types/git.types.d.ts +36 -0
- package/dist/git/types/git.types.js +1 -0
- package/dist/git/types/snapshot.types.d.ts +25 -0
- package/dist/git/types/snapshot.types.js +1 -0
- package/dist/otlp/constants/otlp.constants.d.ts +84 -0
- package/dist/otlp/constants/otlp.constants.js +99 -0
- package/dist/otlp/http.d.ts +24 -0
- package/dist/otlp/http.js +37 -0
- package/dist/otlp/index.d.ts +9 -0
- package/dist/otlp/index.js +3 -0
- package/dist/otlp/normalize.d.ts +14 -0
- package/dist/otlp/normalize.js +404 -0
- package/dist/otlp/types/otlp.types.d.ts +69 -0
- package/dist/otlp/types/otlp.types.js +1 -0
- package/dist/pipeline/constants/pipeline.constants.d.ts +23 -0
- package/dist/pipeline/constants/pipeline.constants.js +22 -0
- package/dist/pipeline/hook-pipeline.d.ts +14 -0
- package/dist/pipeline/hook-pipeline.js +297 -0
- package/dist/pipeline/index.d.ts +6 -0
- package/dist/pipeline/index.js +1 -0
- package/dist/pipeline/types/pipeline.types.d.ts +48 -0
- package/dist/pipeline/types/pipeline.types.js +1 -0
- package/dist/privacy/constants/privacy.constants.d.ts +23 -0
- package/dist/privacy/constants/privacy.constants.js +38 -0
- package/dist/privacy/index.d.ts +7 -0
- package/dist/privacy/index.js +2 -0
- package/dist/privacy/sanitizer.d.ts +20 -0
- package/dist/privacy/sanitizer.js +52 -0
- package/dist/privacy/types/privacy.types.d.ts +13 -0
- package/dist/privacy/types/privacy.types.js +1 -0
- package/dist/providers/antigravity/antigravity.adapter.d.ts +54 -0
- package/dist/providers/antigravity/antigravity.adapter.js +311 -0
- package/dist/providers/antigravity/antigravity.detect.d.ts +25 -0
- package/dist/providers/antigravity/antigravity.detect.js +64 -0
- package/dist/providers/antigravity/antigravity.hooks.d.ts +24 -0
- package/dist/providers/antigravity/antigravity.hooks.js +126 -0
- package/dist/providers/antigravity/antigravity.provider.d.ts +2 -0
- package/dist/providers/antigravity/antigravity.provider.js +22 -0
- package/dist/providers/antigravity/constants/antigravity.constants.d.ts +72 -0
- package/dist/providers/antigravity/constants/antigravity.constants.js +75 -0
- package/dist/providers/antigravity/schemas/antigravity.schema.d.ts +521 -0
- package/dist/providers/antigravity/schemas/antigravity.schema.js +64 -0
- package/dist/providers/antigravity/types/antigravity.types.d.ts +13 -0
- package/dist/providers/antigravity/types/antigravity.types.js +1 -0
- package/dist/providers/claude/claude.adapter.d.ts +15 -0
- package/dist/providers/claude/claude.adapter.js +141 -0
- package/dist/providers/claude/claude.detect.d.ts +20 -0
- package/dist/providers/claude/claude.detect.js +57 -0
- package/dist/providers/claude/claude.hooks.d.ts +23 -0
- package/dist/providers/claude/claude.hooks.js +94 -0
- package/dist/providers/claude/claude.otel.d.ts +95 -0
- package/dist/providers/claude/claude.otel.js +331 -0
- package/dist/providers/claude/claude.provider.d.ts +2 -0
- package/dist/providers/claude/claude.provider.js +26 -0
- package/dist/providers/claude/constants/claude.constants.d.ts +34 -0
- package/dist/providers/claude/constants/claude.constants.js +54 -0
- package/dist/providers/claude/constants/claude.otel.constants.d.ts +17 -0
- package/dist/providers/claude/constants/claude.otel.constants.js +17 -0
- package/dist/providers/claude/schemas/claude.schema.d.ts +72 -0
- package/dist/providers/claude/schemas/claude.schema.js +32 -0
- package/dist/providers/claude/types/claude.types.d.ts +3 -0
- package/dist/providers/claude/types/claude.types.js +1 -0
- package/dist/providers/codex/codex.adapter.d.ts +11 -0
- package/dist/providers/codex/codex.adapter.js +106 -0
- package/dist/providers/codex/codex.detect.d.ts +30 -0
- package/dist/providers/codex/codex.detect.js +58 -0
- package/dist/providers/codex/codex.hooks.d.ts +27 -0
- package/dist/providers/codex/codex.hooks.js +129 -0
- package/dist/providers/codex/codex.otel.d.ts +51 -0
- package/dist/providers/codex/codex.otel.js +325 -0
- package/dist/providers/codex/codex.provider.d.ts +2 -0
- package/dist/providers/codex/codex.provider.js +25 -0
- package/dist/providers/codex/constants/codex.constants.d.ts +41 -0
- package/dist/providers/codex/constants/codex.constants.js +62 -0
- package/dist/providers/codex/constants/codex.otel.constants.d.ts +22 -0
- package/dist/providers/codex/constants/codex.otel.constants.js +22 -0
- package/dist/providers/codex/schemas/codex.schema.d.ts +70 -0
- package/dist/providers/codex/schemas/codex.schema.js +32 -0
- package/dist/providers/codex/types/codex.types.d.ts +3 -0
- package/dist/providers/codex/types/codex.types.js +1 -0
- package/dist/providers/constants/provider.constants.d.ts +33 -0
- package/dist/providers/constants/provider.constants.js +33 -0
- package/dist/providers/cursor/constants/cursor.constants.d.ts +58 -0
- package/dist/providers/cursor/constants/cursor.constants.js +95 -0
- package/dist/providers/cursor/cursor.adapter.d.ts +11 -0
- package/dist/providers/cursor/cursor.adapter.js +331 -0
- package/dist/providers/cursor/cursor.detect.d.ts +23 -0
- package/dist/providers/cursor/cursor.detect.js +66 -0
- package/dist/providers/cursor/cursor.hooks.d.ts +25 -0
- package/dist/providers/cursor/cursor.hooks.js +95 -0
- package/dist/providers/cursor/cursor.provider.d.ts +2 -0
- package/dist/providers/cursor/cursor.provider.js +27 -0
- package/dist/providers/cursor/schemas/cursor.schema.d.ts +130 -0
- package/dist/providers/cursor/schemas/cursor.schema.js +62 -0
- package/dist/providers/cursor/types/cursor.types.d.ts +3 -0
- package/dist/providers/cursor/types/cursor.types.js +1 -0
- package/dist/providers/gemini/constants/gemini.constants.d.ts +36 -0
- package/dist/providers/gemini/constants/gemini.constants.js +58 -0
- package/dist/providers/gemini/constants/gemini.otel.constants.d.ts +34 -0
- package/dist/providers/gemini/constants/gemini.otel.constants.js +48 -0
- package/dist/providers/gemini/gemini.adapter.d.ts +15 -0
- package/dist/providers/gemini/gemini.adapter.js +146 -0
- package/dist/providers/gemini/gemini.detect.d.ts +23 -0
- package/dist/providers/gemini/gemini.detect.js +78 -0
- package/dist/providers/gemini/gemini.hooks.d.ts +22 -0
- package/dist/providers/gemini/gemini.hooks.js +93 -0
- package/dist/providers/gemini/gemini.otel.d.ts +62 -0
- package/dist/providers/gemini/gemini.otel.js +274 -0
- package/dist/providers/gemini/gemini.provider.d.ts +2 -0
- package/dist/providers/gemini/gemini.provider.js +22 -0
- package/dist/providers/gemini/schemas/gemini.schema.d.ts +81 -0
- package/dist/providers/gemini/schemas/gemini.schema.js +35 -0
- package/dist/providers/gemini/types/gemini.types.d.ts +3 -0
- package/dist/providers/gemini/types/gemini.types.js +1 -0
- package/dist/providers/index.d.ts +14 -0
- package/dist/providers/index.js +8 -0
- package/dist/providers/provider.d.ts +16 -0
- package/dist/providers/provider.js +149 -0
- package/dist/providers/registry.d.ts +12 -0
- package/dist/providers/registry.js +23 -0
- package/dist/providers/shared/constants/hook-refusal.constants.d.ts +6 -0
- package/dist/providers/shared/constants/hook-refusal.constants.js +6 -0
- package/dist/providers/shared/constants/tooling.constants.d.ts +25 -0
- package/dist/providers/shared/constants/tooling.constants.js +25 -0
- package/dist/providers/shared/event-builder.d.ts +85 -0
- package/dist/providers/shared/event-builder.js +166 -0
- package/dist/providers/shared/hook-config.d.ts +80 -0
- package/dist/providers/shared/hook-config.js +164 -0
- package/dist/providers/shared/hook-refusal.d.ts +16 -0
- package/dist/providers/shared/hook-refusal.js +33 -0
- package/dist/providers/shared/install-record.d.ts +75 -0
- package/dist/providers/shared/install-record.js +113 -0
- package/dist/providers/shared/tooling.d.ts +58 -0
- package/dist/providers/shared/tooling.js +103 -0
- package/dist/providers/shared/types/adapter.types.d.ts +54 -0
- package/dist/providers/shared/types/adapter.types.js +1 -0
- package/dist/providers/shared/types/hook-config.types.d.ts +32 -0
- package/dist/providers/shared/types/hook-config.types.js +1 -0
- package/dist/providers/types/provider.types.d.ts +98 -0
- package/dist/providers/types/provider.types.js +1 -0
- package/dist/snapshot/branch-selection.d.ts +37 -0
- package/dist/snapshot/branch-selection.js +69 -0
- package/dist/snapshot/budget.d.ts +41 -0
- package/dist/snapshot/budget.js +67 -0
- package/dist/snapshot/constants/snapshot-stages.constants.d.ts +11 -0
- package/dist/snapshot/constants/snapshot-stages.constants.js +11 -0
- package/dist/snapshot/constants/snapshot.constants.d.ts +56 -0
- package/dist/snapshot/constants/snapshot.constants.js +56 -0
- package/dist/snapshot/index.d.ts +16 -0
- package/dist/snapshot/index.js +6 -0
- package/dist/snapshot/snapshot-event.d.ts +17 -0
- package/dist/snapshot/snapshot-event.js +66 -0
- package/dist/snapshot/snapshot-pipeline.d.ts +14 -0
- package/dist/snapshot/snapshot-pipeline.js +163 -0
- package/dist/snapshot/snapshot-state.d.ts +55 -0
- package/dist/snapshot/snapshot-state.js +100 -0
- package/dist/snapshot/types/snapshot.types.d.ts +86 -0
- package/dist/snapshot/types/snapshot.types.js +1 -0
- package/dist/storage/atomic-file.d.ts +25 -0
- package/dist/storage/atomic-file.js +76 -0
- package/dist/storage/constants/storage.constants.d.ts +34 -0
- package/dist/storage/constants/storage.constants.js +35 -0
- package/dist/storage/index.d.ts +10 -0
- package/dist/storage/index.js +5 -0
- package/dist/storage/install-state.d.ts +20 -0
- package/dist/storage/install-state.js +40 -0
- package/dist/storage/json-file.d.ts +13 -0
- package/dist/storage/json-file.js +31 -0
- package/dist/storage/lock.d.ts +15 -0
- package/dist/storage/lock.js +70 -0
- package/dist/storage/paths.d.ts +14 -0
- package/dist/storage/paths.js +42 -0
- package/dist/storage/schemas/storage.schema.d.ts +128 -0
- package/dist/storage/schemas/storage.schema.js +27 -0
- package/dist/storage/types/storage.types.d.ts +36 -0
- package/dist/storage/types/storage.types.js +1 -0
- package/dist/transport/constants/transport.constants.d.ts +47 -0
- package/dist/transport/constants/transport.constants.js +47 -0
- package/dist/transport/cooldown.d.ts +35 -0
- package/dist/transport/cooldown.js +62 -0
- package/dist/transport/delivery-stats.d.ts +65 -0
- package/dist/transport/delivery-stats.js +186 -0
- package/dist/transport/delivery.d.ts +26 -0
- package/dist/transport/delivery.js +80 -0
- package/dist/transport/headers.d.ts +12 -0
- package/dist/transport/headers.js +19 -0
- package/dist/transport/http-transport.d.ts +39 -0
- package/dist/transport/http-transport.js +106 -0
- package/dist/transport/index.d.ts +13 -0
- package/dist/transport/index.js +7 -0
- package/dist/transport/queue.d.ts +177 -0
- package/dist/transport/queue.js +474 -0
- package/dist/transport/schemas/queue.schema.d.ts +30 -0
- package/dist/transport/schemas/queue.schema.js +18 -0
- package/dist/transport/transport.d.ts +6 -0
- package/dist/transport/transport.js +1 -0
- package/dist/transport/types/transport.types.d.ts +102 -0
- package/dist/transport/types/transport.types.js +1 -0
- package/dist/turns/aggregate-usage.d.ts +20 -0
- package/dist/turns/aggregate-usage.js +269 -0
- package/dist/turns/claude-transcript.d.ts +18 -0
- package/dist/turns/claude-transcript.js +80 -0
- package/dist/turns/constants/turns.constants.d.ts +69 -0
- package/dist/turns/constants/turns.constants.js +86 -0
- package/dist/turns/cursor-transcript.d.ts +21 -0
- package/dist/turns/cursor-transcript.js +66 -0
- package/dist/turns/index.d.ts +17 -0
- package/dist/turns/index.js +7 -0
- package/dist/turns/transcript.d.ts +74 -0
- package/dist/turns/transcript.js +188 -0
- package/dist/turns/turn-state.d.ts +94 -0
- package/dist/turns/turn-state.js +234 -0
- package/dist/turns/turn-summary.d.ts +27 -0
- package/dist/turns/turn-summary.js +164 -0
- package/dist/turns/turn-tracker.d.ts +14 -0
- package/dist/turns/turn-tracker.js +521 -0
- package/dist/turns/types/aggregate-usage.types.d.ts +26 -0
- package/dist/turns/types/aggregate-usage.types.js +1 -0
- package/dist/turns/types/transcript.types.d.ts +41 -0
- package/dist/turns/types/transcript.types.js +1 -0
- package/dist/turns/types/turn-state.types.d.ts +37 -0
- package/dist/turns/types/turn-state.types.js +1 -0
- package/dist/turns/types/turn-summary.types.d.ts +106 -0
- package/dist/turns/types/turn-summary.types.js +1 -0
- package/dist/turns/types/turn-tracker.types.d.ts +27 -0
- package/dist/turns/types/turn-tracker.types.js +1 -0
- package/example/README.md +43 -0
- package/example/server.mjs +240 -0
- package/package.json +89 -0
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { z } from 'zod';
|
|
2
|
+
import type { ANTIGRAVITY_HOOK_EVENT_BY_ARGS } from '../constants/antigravity.constants.js';
|
|
3
|
+
import type { antigravityPayloadSchema } from '../schemas/antigravity.schema.js';
|
|
4
|
+
export type AntigravityPayload = z.infer<typeof antigravityPayloadSchema>;
|
|
5
|
+
/** Which oneof member of `HookArgs` was set. */
|
|
6
|
+
export type AntigravityArgsKey = keyof typeof ANTIGRAVITY_HOOK_EVENT_BY_ARGS;
|
|
7
|
+
/** The hook Antigravity fired, in hooks.json naming. */
|
|
8
|
+
export type AntigravityHookEvent = (typeof ANTIGRAVITY_HOOK_EVENT_BY_ARGS)[AntigravityArgsKey];
|
|
9
|
+
/** A tool call as Antigravity reports it. */
|
|
10
|
+
export interface AntigravityToolCall {
|
|
11
|
+
readonly name?: string;
|
|
12
|
+
readonly args?: unknown;
|
|
13
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { AgentWatchEvent } from '../../events/types/events.types.js';
|
|
2
|
+
import type { HookContext } from '../types/provider.types.js';
|
|
3
|
+
export type { ClaudePayload } from './types/claude.types.js';
|
|
4
|
+
/**
|
|
5
|
+
* Translate one Claude Code hook payload into canonical events.
|
|
6
|
+
*
|
|
7
|
+
* An unrecognizable payload yields no events rather than an error: the hook has
|
|
8
|
+
* to answer the agent either way, and a Claude Code release that changes its
|
|
9
|
+
* schema must cost telemetry, not the developer's session.
|
|
10
|
+
*
|
|
11
|
+
* @param rawPayload - Raw JSON from the hook's stdin.
|
|
12
|
+
* @param context - Environment and effective config.
|
|
13
|
+
* @returns The canonical events, or an empty list.
|
|
14
|
+
*/
|
|
15
|
+
export declare function parseClaudeHookEvent(rawPayload: unknown, context: HookContext): AgentWatchEvent[];
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { sha256Hex } from '../../events/event-id.js';
|
|
2
|
+
import { baseEvent, promptPatch, responsePatch, toolPatch, withPatch } from '../shared/event-builder.js';
|
|
3
|
+
import { classifyTool, parseMcpToolName, toolCompleteType, toolStartType } from '../shared/tooling.js';
|
|
4
|
+
import { CLAUDE_DISPLAY_NAME, CLAUDE_EVENT_TYPE_MAP, CLAUDE_PROVIDER_ID, CLAUDE_TOOL_EVENTS, CLAUDE_TOOL_START_EVENTS, CLAUDE_UNKNOWN_EVENT } from './constants/claude.constants.js';
|
|
5
|
+
import { claudePayloadSchema } from './schemas/claude.schema.js';
|
|
6
|
+
/**
|
|
7
|
+
* Translate one Claude Code hook payload into canonical events.
|
|
8
|
+
*
|
|
9
|
+
* An unrecognizable payload yields no events rather than an error: the hook has
|
|
10
|
+
* to answer the agent either way, and a Claude Code release that changes its
|
|
11
|
+
* schema must cost telemetry, not the developer's session.
|
|
12
|
+
*
|
|
13
|
+
* @param rawPayload - Raw JSON from the hook's stdin.
|
|
14
|
+
* @param context - Environment and effective config.
|
|
15
|
+
* @returns The canonical events, or an empty list.
|
|
16
|
+
*/
|
|
17
|
+
export function parseClaudeHookEvent(rawPayload, context) {
|
|
18
|
+
const parsed = claudePayloadSchema.safeParse(rawPayload);
|
|
19
|
+
if (!parsed.success)
|
|
20
|
+
return [];
|
|
21
|
+
const payload = parsed.data;
|
|
22
|
+
const providerEventType = payload.hook_event_name ?? CLAUDE_UNKNOWN_EVENT;
|
|
23
|
+
return [withPatch(claudeBaseEvent(payload, providerEventType), hookPatch(payload, providerEventType, context))];
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* The provider-independent part of the event.
|
|
27
|
+
*
|
|
28
|
+
* @param payload - Parsed hook payload.
|
|
29
|
+
* @param providerEventType - Claude's own name for this hook.
|
|
30
|
+
* @returns The base event.
|
|
31
|
+
*/
|
|
32
|
+
function claudeBaseEvent(payload, providerEventType) {
|
|
33
|
+
return baseEvent({
|
|
34
|
+
provider: CLAUDE_PROVIDER_ID,
|
|
35
|
+
displayName: CLAUDE_DISPLAY_NAME,
|
|
36
|
+
providerEventType,
|
|
37
|
+
eventType: canonicalType(payload, providerEventType),
|
|
38
|
+
sessionId: payload.session_id,
|
|
39
|
+
// prompt_id groups every event of one prompt→response turn and matches
|
|
40
|
+
// OTel prompt.id, which is what makes cost joins possible downstream.
|
|
41
|
+
turnId: payload.prompt_id,
|
|
42
|
+
agentId: payload.agent_id,
|
|
43
|
+
toolUseId: payload.tool_use_id,
|
|
44
|
+
promptId: payload.prompt_id,
|
|
45
|
+
// Hash only: it disambiguates otherwise-identical events (two Stops in one
|
|
46
|
+
// session) without any content reaching the id.
|
|
47
|
+
payloadFingerprint: sha256Hex(JSON.stringify(payload)),
|
|
48
|
+
providerMetadata: {
|
|
49
|
+
promptId: payload.prompt_id,
|
|
50
|
+
permissionMode: payload.permission_mode,
|
|
51
|
+
agentType: payload.agent_type
|
|
52
|
+
},
|
|
53
|
+
timestamp: new Date().toISOString()
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* What this particular hook contributes on top of the base event.
|
|
58
|
+
*
|
|
59
|
+
* @param payload - Parsed hook payload.
|
|
60
|
+
* @param providerEventType - Claude's own name for this hook.
|
|
61
|
+
* @param context - Environment and effective config.
|
|
62
|
+
* @returns The patch; empty for a hook we model but read nothing from.
|
|
63
|
+
*/
|
|
64
|
+
function hookPatch(payload, providerEventType, context) {
|
|
65
|
+
const capture = context.config.capture;
|
|
66
|
+
if (providerEventType === 'SessionStart') {
|
|
67
|
+
return {
|
|
68
|
+
metadata: { sessionSource: payload.source },
|
|
69
|
+
ai: payload.model ? { model: payload.model } : undefined
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
if (providerEventType === 'SessionEnd')
|
|
73
|
+
return { metadata: { sessionEndReason: payload.reason } };
|
|
74
|
+
if (providerEventType === 'UserPromptSubmit')
|
|
75
|
+
return promptPatch(payload.prompt ?? '', capture);
|
|
76
|
+
if (CLAUDE_TOOL_EVENTS.has(providerEventType))
|
|
77
|
+
return claudeToolPatch(payload, providerEventType, context);
|
|
78
|
+
if (providerEventType === 'Stop') {
|
|
79
|
+
const response = responsePatch(payload.last_assistant_message ?? '', capture);
|
|
80
|
+
return { ...response, metadata: { stopHookActive: payload.stop_hook_active, ...response.metadata } };
|
|
81
|
+
}
|
|
82
|
+
if (providerEventType === 'SubagentStart' || providerEventType === 'SubagentStop') {
|
|
83
|
+
return { session: { agentId: payload.agent_id }, metadata: { agentType: payload.agent_type } };
|
|
84
|
+
}
|
|
85
|
+
return {};
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Tool fields for one of Claude's four tool hooks.
|
|
89
|
+
*
|
|
90
|
+
* @param payload - Parsed hook payload.
|
|
91
|
+
* @param providerEventType - Claude's own name for this hook.
|
|
92
|
+
* @param context - Environment and effective config.
|
|
93
|
+
* @returns The patch.
|
|
94
|
+
*/
|
|
95
|
+
function claudeToolPatch(payload, providerEventType, context) {
|
|
96
|
+
const kind = classifyTool(payload.tool_name);
|
|
97
|
+
const mcp = kind === 'mcp' && payload.tool_name ? parseMcpToolName(payload.tool_name) : undefined;
|
|
98
|
+
return toolPatch({
|
|
99
|
+
name: payload.tool_name,
|
|
100
|
+
status: toolStatus(providerEventType),
|
|
101
|
+
kind,
|
|
102
|
+
toolUseId: payload.tool_use_id,
|
|
103
|
+
input: payload.tool_input,
|
|
104
|
+
output: payload.tool_response,
|
|
105
|
+
error: providerEventType === 'PostToolUseFailure' ? payload.tool_error : undefined,
|
|
106
|
+
providerFields: mcp ? { mcpServer: mcp.server, mcpTool: mcp.tool } : undefined
|
|
107
|
+
}, context.config.capture);
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Whether a tool hook reports a start, a failure, or a completion.
|
|
111
|
+
*
|
|
112
|
+
* @param providerEventType - Claude's own name for this hook.
|
|
113
|
+
* @returns The tool status.
|
|
114
|
+
*/
|
|
115
|
+
function toolStatus(providerEventType) {
|
|
116
|
+
if (CLAUDE_TOOL_START_EVENTS.has(providerEventType))
|
|
117
|
+
return 'started';
|
|
118
|
+
if (providerEventType === 'PostToolUseFailure')
|
|
119
|
+
return 'failed';
|
|
120
|
+
return 'completed';
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Canonical type for a hook, falling back to the tool classification.
|
|
124
|
+
*
|
|
125
|
+
* @param payload - Parsed hook payload.
|
|
126
|
+
* @param providerEventType - Claude's own name for this hook.
|
|
127
|
+
* @returns The canonical event type.
|
|
128
|
+
*/
|
|
129
|
+
function canonicalType(payload, providerEventType) {
|
|
130
|
+
const direct = CLAUDE_EVENT_TYPE_MAP[providerEventType];
|
|
131
|
+
if (direct)
|
|
132
|
+
return direct;
|
|
133
|
+
const kind = classifyTool(payload.tool_name);
|
|
134
|
+
if (providerEventType === 'PreToolUse')
|
|
135
|
+
return toolStartType(kind);
|
|
136
|
+
if (providerEventType === 'PostToolUse')
|
|
137
|
+
return toolCompleteType(kind);
|
|
138
|
+
if (providerEventType === 'PostToolUseFailure')
|
|
139
|
+
return 'tool.failed';
|
|
140
|
+
return 'agent.other';
|
|
141
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { Env } from '../../core/types/core.types.js';
|
|
2
|
+
import type { DetectionResult } from '../types/provider.types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Where Claude Code keeps the settings file AgentWatch registers hooks in.
|
|
5
|
+
*
|
|
6
|
+
* @param env - Environment supplying HOME.
|
|
7
|
+
* @returns Absolute path of `~/.claude/settings.json`.
|
|
8
|
+
*/
|
|
9
|
+
export declare function claudeSettingsPath(env: Env): string;
|
|
10
|
+
/**
|
|
11
|
+
* Whether Claude Code is installed here, and whether our hooks are registered.
|
|
12
|
+
*
|
|
13
|
+
* Detection is evidence-based rather than a single test: a developer may have
|
|
14
|
+
* the CLI on PATH without a home directory yet, or a project-local `.claude`
|
|
15
|
+
* without a global install.
|
|
16
|
+
*
|
|
17
|
+
* @param env - Environment supplying HOME, cwd and PATH.
|
|
18
|
+
* @returns What was found.
|
|
19
|
+
*/
|
|
20
|
+
export declare function detectClaude(env: Env): Promise<DetectionResult>;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { asRecord } from '../../core/object.js';
|
|
4
|
+
import { findExecutable } from '../../core/which.js';
|
|
5
|
+
import { readJsonFile } from '../../storage/json-file.js';
|
|
6
|
+
import { HOOK_COMMAND_MARKER } from '../constants/provider.constants.js';
|
|
7
|
+
import { CLAUDE_EXECUTABLE, CLAUDE_HOME_DIR, CLAUDE_SETTINGS_FILE } from './constants/claude.constants.js';
|
|
8
|
+
/**
|
|
9
|
+
* Where Claude Code keeps the settings file AgentWatch registers hooks in.
|
|
10
|
+
*
|
|
11
|
+
* @param env - Environment supplying HOME.
|
|
12
|
+
* @returns Absolute path of `~/.claude/settings.json`.
|
|
13
|
+
*/
|
|
14
|
+
export function claudeSettingsPath(env) {
|
|
15
|
+
return path.join(env.home, CLAUDE_HOME_DIR, CLAUDE_SETTINGS_FILE);
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Whether Claude Code is installed here, and whether our hooks are registered.
|
|
19
|
+
*
|
|
20
|
+
* Detection is evidence-based rather than a single test: a developer may have
|
|
21
|
+
* the CLI on PATH without a home directory yet, or a project-local `.claude`
|
|
22
|
+
* without a global install.
|
|
23
|
+
*
|
|
24
|
+
* @param env - Environment supplying HOME, cwd and PATH.
|
|
25
|
+
* @returns What was found.
|
|
26
|
+
*/
|
|
27
|
+
export async function detectClaude(env) {
|
|
28
|
+
const evidence = [];
|
|
29
|
+
if (fs.existsSync(path.join(env.home, CLAUDE_HOME_DIR)))
|
|
30
|
+
evidence.push('~/.claude directory exists');
|
|
31
|
+
if (fs.existsSync(path.join(env.cwd, CLAUDE_HOME_DIR)))
|
|
32
|
+
evidence.push('.claude directory in working tree');
|
|
33
|
+
const executablePath = findExecutable(env, CLAUDE_EXECUTABLE);
|
|
34
|
+
if (executablePath)
|
|
35
|
+
evidence.push(`claude executable on PATH (${executablePath})`);
|
|
36
|
+
const hookConfigPath = claudeSettingsPath(env);
|
|
37
|
+
return {
|
|
38
|
+
detected: evidence.length > 0,
|
|
39
|
+
evidence,
|
|
40
|
+
executablePath,
|
|
41
|
+
hookConfigPath,
|
|
42
|
+
hooksInstalled: await hasOurHooks(hookConfigPath)
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Whether the settings file already names the agentwatch hook command.
|
|
47
|
+
*
|
|
48
|
+
* @param settingsPath - Claude settings file.
|
|
49
|
+
* @returns True when our marker appears in the hooks block.
|
|
50
|
+
*/
|
|
51
|
+
async function hasOurHooks(settingsPath) {
|
|
52
|
+
const read = await readJsonFile(settingsPath);
|
|
53
|
+
const settings = read.state === 'ok' ? asRecord(read.value) : undefined;
|
|
54
|
+
if (!settings)
|
|
55
|
+
return false;
|
|
56
|
+
return JSON.stringify(settings['hooks'] ?? {}).includes(HOOK_COMMAND_MARKER);
|
|
57
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { SetupContext, SetupOutcome } from '../types/provider.types.js';
|
|
2
|
+
export { CLAUDE_HOOK_EVENTS } from './constants/claude.constants.js';
|
|
3
|
+
/**
|
|
4
|
+
* Register AgentWatch's hooks in `~/.claude/settings.json`.
|
|
5
|
+
*
|
|
6
|
+
* Everything the user owns survives: their handlers inside our matcher groups,
|
|
7
|
+
* their own groups, and every unrelated setting in the file. Our previous
|
|
8
|
+
* handlers are stripped before the fresh one is added, because two
|
|
9
|
+
* registrations would make every turn be processed — and counted — twice.
|
|
10
|
+
*
|
|
11
|
+
* @param context - Environment, paths, config and the hook command to write.
|
|
12
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
13
|
+
* install state.
|
|
14
|
+
*/
|
|
15
|
+
export declare function installClaudeHooks(context: SetupContext): Promise<SetupOutcome>;
|
|
16
|
+
/**
|
|
17
|
+
* Remove AgentWatch's hooks from `~/.claude/settings.json`.
|
|
18
|
+
*
|
|
19
|
+
* @param context - Environment, paths and current install state.
|
|
20
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
21
|
+
* install state.
|
|
22
|
+
*/
|
|
23
|
+
export declare function uninstallClaudeHooks(context: SetupContext): Promise<SetupOutcome>;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { asRecord } from '../../core/object.js';
|
|
2
|
+
import { backupFile } from '../../storage/atomic-file.js';
|
|
3
|
+
import { readJsonFile } from '../../storage/json-file.js';
|
|
4
|
+
import { registerOurHandlers, stripOurHandlers, sweepUnregisteredEvents, withHooksBlock, writeJsonValidated } from '../shared/hook-config.js';
|
|
5
|
+
import { withHookInstall, withoutHookInstall } from '../shared/install-record.js';
|
|
6
|
+
import { CLAUDE_HOOK_EVENTS, CLAUDE_HOOK_TIMEOUT_SECONDS, CLAUDE_MATCHED_EVENTS, CLAUDE_PROVIDER_ID } from './constants/claude.constants.js';
|
|
7
|
+
import { claudeSettingsPath } from './claude.detect.js';
|
|
8
|
+
export { CLAUDE_HOOK_EVENTS } from './constants/claude.constants.js';
|
|
9
|
+
/**
|
|
10
|
+
* Register AgentWatch's hooks in `~/.claude/settings.json`.
|
|
11
|
+
*
|
|
12
|
+
* Everything the user owns survives: their handlers inside our matcher groups,
|
|
13
|
+
* their own groups, and every unrelated setting in the file. Our previous
|
|
14
|
+
* handlers are stripped before the fresh one is added, because two
|
|
15
|
+
* registrations would make every turn be processed — and counted — twice.
|
|
16
|
+
*
|
|
17
|
+
* @param context - Environment, paths, config and the hook command to write.
|
|
18
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
19
|
+
* install state.
|
|
20
|
+
*/
|
|
21
|
+
export async function installClaudeHooks(context) {
|
|
22
|
+
const settingsPath = claudeSettingsPath(context.env);
|
|
23
|
+
const read = await readJsonFile(settingsPath);
|
|
24
|
+
if (read.state === 'invalid') {
|
|
25
|
+
return { ok: false, changed: false, messages: [`refusing to modify unparseable ${settingsPath} (${read.error})`] };
|
|
26
|
+
}
|
|
27
|
+
if (read.state === 'ok' && !asRecord(read.value)) {
|
|
28
|
+
return { ok: false, changed: false, messages: [`refusing to modify ${settingsPath}: top level is not an object`] };
|
|
29
|
+
}
|
|
30
|
+
const settings = (read.state === 'ok' ? asRecord(read.value) : undefined) ?? {};
|
|
31
|
+
const hooks = asRecord(settings['hooks']) ?? {};
|
|
32
|
+
const registered = registerOurHandlers(hooks, CLAUDE_HOOK_EVENTS, hookEntryFor(context.hookCommand));
|
|
33
|
+
const nextSettings = { ...settings, hooks: sweepUnregisteredEvents(registered, CLAUDE_HOOK_EVENTS) };
|
|
34
|
+
const changed = JSON.stringify(nextSettings) !== JSON.stringify(settings);
|
|
35
|
+
if (changed) {
|
|
36
|
+
await backupFile(settingsPath, context.paths.backupsDir, context.env.now());
|
|
37
|
+
await writeJsonValidated(settingsPath, nextSettings);
|
|
38
|
+
}
|
|
39
|
+
return {
|
|
40
|
+
ok: true,
|
|
41
|
+
changed,
|
|
42
|
+
messages: changed ? [`hooks registered in ${settingsPath}`] : ['hooks already registered'],
|
|
43
|
+
installState: withHookInstall(context.installState, CLAUDE_PROVIDER_ID, {
|
|
44
|
+
hookConfigPath: settingsPath,
|
|
45
|
+
hookEvents: CLAUDE_HOOK_EVENTS,
|
|
46
|
+
hookCommand: context.hookCommand,
|
|
47
|
+
installedAt: context.env.now()
|
|
48
|
+
})
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Remove AgentWatch's hooks from `~/.claude/settings.json`.
|
|
53
|
+
*
|
|
54
|
+
* @param context - Environment, paths and current install state.
|
|
55
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
56
|
+
* install state.
|
|
57
|
+
*/
|
|
58
|
+
export async function uninstallClaudeHooks(context) {
|
|
59
|
+
const settingsPath = claudeSettingsPath(context.env);
|
|
60
|
+
const read = await readJsonFile(settingsPath);
|
|
61
|
+
if (read.state === 'missing')
|
|
62
|
+
return { ok: true, changed: false, messages: ['no Claude settings file'] };
|
|
63
|
+
const settings = read.state === 'ok' ? asRecord(read.value) : undefined;
|
|
64
|
+
if (!settings)
|
|
65
|
+
return { ok: false, changed: false, messages: [`cannot parse ${settingsPath}; not modified`] };
|
|
66
|
+
const hooks = asRecord(settings['hooks']);
|
|
67
|
+
if (!hooks)
|
|
68
|
+
return { ok: true, changed: false, messages: ['no hooks configured'] };
|
|
69
|
+
const stripped = stripOurHandlers(hooks);
|
|
70
|
+
const nextSettings = withHooksBlock(settings, stripped.hooks);
|
|
71
|
+
if (stripped.changed) {
|
|
72
|
+
await backupFile(settingsPath, context.paths.backupsDir, context.env.now());
|
|
73
|
+
await writeJsonValidated(settingsPath, nextSettings);
|
|
74
|
+
}
|
|
75
|
+
return {
|
|
76
|
+
ok: true,
|
|
77
|
+
changed: stripped.changed,
|
|
78
|
+
messages: stripped.changed ? ['AgentWatch hooks removed'] : ['no AgentWatch hooks found'],
|
|
79
|
+
installState: withoutHookInstall(context.installState, CLAUDE_PROVIDER_ID)
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Our entry for one event: a dedicated matcher group holding one handler.
|
|
84
|
+
*
|
|
85
|
+
* @param hookCommand - Command line agents will invoke.
|
|
86
|
+
* @returns A factory producing the entry for a given event name.
|
|
87
|
+
*/
|
|
88
|
+
function hookEntryFor(hookCommand) {
|
|
89
|
+
return (eventName) => ({
|
|
90
|
+
// Tool-scoped events require a matcher; "*" observes every tool.
|
|
91
|
+
...(CLAUDE_MATCHED_EVENTS.has(eventName) ? { matcher: '*' } : {}),
|
|
92
|
+
hooks: [{ type: 'command', command: hookCommand, timeout: CLAUDE_HOOK_TIMEOUT_SECONDS }]
|
|
93
|
+
});
|
|
94
|
+
}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import type { Env } from '../../core/types/core.types.js';
|
|
2
|
+
import type { NativeTelemetryConfigurator, NativeTelemetryStatus, SetupContext, SetupOutcome } from '../types/provider.types.js';
|
|
3
|
+
/**
|
|
4
|
+
* The telemetry environment AgentWatch wants in Claude Code's settings.
|
|
5
|
+
*
|
|
6
|
+
* Claude Code's native OpenTelemetry (verified against
|
|
7
|
+
* code.claude.com/docs/en/monitoring-usage, 2026-08) is configured through the
|
|
8
|
+
* settings.json `env` block. Each `claude_code.api_request` log becomes one
|
|
9
|
+
* llm.call; the enhanced-traces beta adds `claude_code.llm_request` spans
|
|
10
|
+
* carrying query_source/agent_id, which is what keeps child-agent traffic from
|
|
11
|
+
* being folded into the main agent.
|
|
12
|
+
*
|
|
13
|
+
* @param context - Environment, paths and effective config.
|
|
14
|
+
* @returns The desired variables, or undefined when telemetry is off or no
|
|
15
|
+
* backend is configured.
|
|
16
|
+
*/
|
|
17
|
+
export declare function desiredClaudeOtelEnv(context: SetupContext): Record<string, string> | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* The `agentwatch otel-headers` command for this install.
|
|
20
|
+
*
|
|
21
|
+
* Bearer auth goes through Claude's documented header-helper hook so the token
|
|
22
|
+
* never lands in the settings file — which is world-readable, committed by some
|
|
23
|
+
* users, and backed up by others.
|
|
24
|
+
*
|
|
25
|
+
* @param hookCommand - The generated `<bin> hook --agent claude` command.
|
|
26
|
+
* @returns The helper command reusing the same binary path.
|
|
27
|
+
*/
|
|
28
|
+
export declare function headersHelperCommand(hookCommand: string): string;
|
|
29
|
+
/**
|
|
30
|
+
* Configures Claude Code's own OTLP export, which is where the llm.call usage
|
|
31
|
+
* ledger comes from.
|
|
32
|
+
*/
|
|
33
|
+
export declare class ClaudeOtelConfigurator implements NativeTelemetryConfigurator {
|
|
34
|
+
/**
|
|
35
|
+
* Whether this agent can export native telemetry at all.
|
|
36
|
+
*
|
|
37
|
+
* @param _env - Unused; Claude Code always supports it.
|
|
38
|
+
* @returns Always true.
|
|
39
|
+
*/
|
|
40
|
+
supported(_env: Env): Promise<boolean>;
|
|
41
|
+
/**
|
|
42
|
+
* Report whether the machine's telemetry configuration matches what we want.
|
|
43
|
+
*
|
|
44
|
+
* @param context - Environment, paths, config and install state.
|
|
45
|
+
* @returns The status, naming any foreign configuration in the way.
|
|
46
|
+
*/
|
|
47
|
+
inspect(context: SetupContext): Promise<NativeTelemetryStatus>;
|
|
48
|
+
/**
|
|
49
|
+
* Write the telemetry configuration into Claude Code's settings.
|
|
50
|
+
*
|
|
51
|
+
* Refuses rather than overwrites when a telemetry variable is already set to
|
|
52
|
+
* something we did not write: the user may be exporting to their own
|
|
53
|
+
* collector, and silently redirecting that would be the worst possible
|
|
54
|
+
* outcome of installing a telemetry edge.
|
|
55
|
+
*
|
|
56
|
+
* @param context - Environment, paths, config and install state.
|
|
57
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
58
|
+
* install state.
|
|
59
|
+
*/
|
|
60
|
+
configure(context: SetupContext): Promise<SetupOutcome>;
|
|
61
|
+
/**
|
|
62
|
+
* Remove the telemetry configuration AgentWatch wrote.
|
|
63
|
+
*
|
|
64
|
+
* Only our own keys go. Without a recorded key list we fall back to the
|
|
65
|
+
* well-known ones, and then only when their values are the ones we would have
|
|
66
|
+
* written — user-owned telemetry config is never removed.
|
|
67
|
+
*
|
|
68
|
+
* @param context - Environment, paths, config and install state.
|
|
69
|
+
* @returns Whether the file changed, what to tell the user, and the next
|
|
70
|
+
* install state.
|
|
71
|
+
*/
|
|
72
|
+
uninstall(context: SetupContext): Promise<SetupOutcome>;
|
|
73
|
+
/**
|
|
74
|
+
* Handle `configure` when telemetry is off or unconfigurable.
|
|
75
|
+
*
|
|
76
|
+
* @param context - Environment, paths, config and install state.
|
|
77
|
+
* @returns The outcome.
|
|
78
|
+
*/
|
|
79
|
+
private configureDisabled;
|
|
80
|
+
/**
|
|
81
|
+
* Add the header-helper command when a token needs one.
|
|
82
|
+
*
|
|
83
|
+
* @param settings - Settings with the env block already updated.
|
|
84
|
+
* @param context - Environment, paths, config and install state.
|
|
85
|
+
* @returns The next settings and the extra owned key, or a conflict message.
|
|
86
|
+
*/
|
|
87
|
+
private applyHeadersHelper;
|
|
88
|
+
/**
|
|
89
|
+
* Settings keys a previous AgentWatch setup recorded as its own.
|
|
90
|
+
*
|
|
91
|
+
* @param context - Install state carrier.
|
|
92
|
+
* @returns The recorded keys.
|
|
93
|
+
*/
|
|
94
|
+
private ownedKeys;
|
|
95
|
+
}
|