@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,409 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
/**
|
|
3
|
+
* Everything is captured by default so the backend gets full turn context
|
|
4
|
+
* (prompts, responses, tool I/O, tokens); users opt out per field. Secrets are
|
|
5
|
+
* still scrubbed by the sanitizer regardless of these flags.
|
|
6
|
+
*/
|
|
7
|
+
export declare const captureSchema: z.ZodObject<{
|
|
8
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
9
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
10
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
11
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
12
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
13
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
14
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
15
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
16
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
17
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
18
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
19
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
20
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
21
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
22
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
23
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
24
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
25
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
26
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
27
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
28
|
+
}, z.ZodTypeAny, "passthrough">>;
|
|
29
|
+
/** Tuning for the in-hook send and the machine-global offline queue. */
|
|
30
|
+
export declare const deliverySchema: z.ZodObject<{
|
|
31
|
+
/** Budget for the in-hook direct send. Keep small: we are on the agent's critical path. */
|
|
32
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
33
|
+
/** How many queued events one drain pass may send. */
|
|
34
|
+
drainBatchSize: z.ZodDefault<z.ZodNumber>;
|
|
35
|
+
maxQueueEvents: z.ZodDefault<z.ZodNumber>;
|
|
36
|
+
maxAttempts: z.ZodDefault<z.ZodNumber>;
|
|
37
|
+
maxEventAgeDays: z.ZodDefault<z.ZodNumber>;
|
|
38
|
+
}, "strip", z.ZodTypeAny, {
|
|
39
|
+
timeoutMs: number;
|
|
40
|
+
drainBatchSize: number;
|
|
41
|
+
maxQueueEvents: number;
|
|
42
|
+
maxAttempts: number;
|
|
43
|
+
maxEventAgeDays: number;
|
|
44
|
+
}, {
|
|
45
|
+
timeoutMs?: number | undefined;
|
|
46
|
+
drainBatchSize?: number | undefined;
|
|
47
|
+
maxQueueEvents?: number | undefined;
|
|
48
|
+
maxAttempts?: number | undefined;
|
|
49
|
+
maxEventAgeDays?: number | undefined;
|
|
50
|
+
}>;
|
|
51
|
+
/**
|
|
52
|
+
* Which native OTLP signals agents export straight to the backend. Logs are
|
|
53
|
+
* the per-request usage/cost ledger the backend turns into llm.call — the
|
|
54
|
+
* default. Traces add latency/subagent spans, metrics add aggregate counters
|
|
55
|
+
* (cost, tokens, active time); both are off unless asked for.
|
|
56
|
+
*/
|
|
57
|
+
export declare const otelSchema: z.ZodObject<{
|
|
58
|
+
logs: z.ZodDefault<z.ZodBoolean>;
|
|
59
|
+
traces: z.ZodDefault<z.ZodBoolean>;
|
|
60
|
+
metrics: z.ZodDefault<z.ZodBoolean>;
|
|
61
|
+
}, "strip", z.ZodTypeAny, {
|
|
62
|
+
logs: boolean;
|
|
63
|
+
traces: boolean;
|
|
64
|
+
metrics: boolean;
|
|
65
|
+
}, {
|
|
66
|
+
logs?: boolean | undefined;
|
|
67
|
+
traces?: boolean | undefined;
|
|
68
|
+
metrics?: boolean | undefined;
|
|
69
|
+
}>;
|
|
70
|
+
/**
|
|
71
|
+
* The pre-turn budget check.
|
|
72
|
+
*
|
|
73
|
+
* On by default: a cap a tenant marked `block` in the dashboard is meant to
|
|
74
|
+
* block, and a guardrail nobody switched on is the same notification nobody
|
|
75
|
+
* acted on. Only an explicit refusal from the platform ever stops a turn — see
|
|
76
|
+
* `src/enforcement/enforcement.ts` — so leaving it on costs a developer one
|
|
77
|
+
* bounded request per turn and nothing else.
|
|
78
|
+
*/
|
|
79
|
+
export declare const enforcementSchema: z.ZodObject<{
|
|
80
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
81
|
+
/** Hard ceiling for the check; it sits between enter and the agent's first call. */
|
|
82
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
83
|
+
/** Mirrors the platform's own cache TTL for the same decision. */
|
|
84
|
+
cacheTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
85
|
+
}, "strip", z.ZodTypeAny, {
|
|
86
|
+
timeoutMs: number;
|
|
87
|
+
enabled: boolean;
|
|
88
|
+
cacheTtlMs: number;
|
|
89
|
+
}, {
|
|
90
|
+
timeoutMs?: number | undefined;
|
|
91
|
+
enabled?: boolean | undefined;
|
|
92
|
+
cacheTtlMs?: number | undefined;
|
|
93
|
+
}>;
|
|
94
|
+
/** Which records the edge itself emits. */
|
|
95
|
+
export declare const emitSchema: z.ZodObject<{
|
|
96
|
+
/** One flat summary per prompt→response turn, emitted on Stop. */
|
|
97
|
+
turnSummaries: z.ZodDefault<z.ZodBoolean>;
|
|
98
|
+
/**
|
|
99
|
+
* Every provider request is mandatory: it is the lossless usage ledger.
|
|
100
|
+
* Accept a legacy `false` on input, but migrate that field to `true`
|
|
101
|
+
* instead of invalidating the entire global config.
|
|
102
|
+
*/
|
|
103
|
+
llmCalls: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, true, boolean | undefined>;
|
|
104
|
+
}, "strip", z.ZodTypeAny, {
|
|
105
|
+
llmCalls: true;
|
|
106
|
+
turnSummaries: boolean;
|
|
107
|
+
}, {
|
|
108
|
+
llmCalls?: boolean | undefined;
|
|
109
|
+
turnSummaries?: boolean | undefined;
|
|
110
|
+
}>;
|
|
111
|
+
/** The whole configuration file. Passthrough: forward compatibility. */
|
|
112
|
+
export declare const configSchema: z.ZodObject<{
|
|
113
|
+
schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
|
|
114
|
+
/** Backend base URL, e.g. https://backend.example.com */
|
|
115
|
+
endpoint: z.ZodOptional<z.ZodString>;
|
|
116
|
+
/** Overrides; derived from endpoint when absent. */
|
|
117
|
+
eventsUrl: z.ZodOptional<z.ZodString>;
|
|
118
|
+
otlpUrl: z.ZodOptional<z.ZodString>;
|
|
119
|
+
enforcementUrl: z.ZodOptional<z.ZodString>;
|
|
120
|
+
token: z.ZodOptional<z.ZodString>;
|
|
121
|
+
installationId: z.ZodOptional<z.ZodString>;
|
|
122
|
+
/** Developer identity attached to turn summaries; falls back to `git config user.email`. */
|
|
123
|
+
developerEmail: z.ZodOptional<z.ZodString>;
|
|
124
|
+
capture: z.ZodDefault<z.ZodObject<{
|
|
125
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
126
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
127
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
128
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
129
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
130
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
131
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
132
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
133
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
134
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
135
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
136
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
137
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
138
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
139
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
140
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
141
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
142
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
143
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
144
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
145
|
+
}, z.ZodTypeAny, "passthrough">>>;
|
|
146
|
+
emit: z.ZodDefault<z.ZodObject<{
|
|
147
|
+
/** One flat summary per prompt→response turn, emitted on Stop. */
|
|
148
|
+
turnSummaries: z.ZodDefault<z.ZodBoolean>;
|
|
149
|
+
/**
|
|
150
|
+
* Every provider request is mandatory: it is the lossless usage ledger.
|
|
151
|
+
* Accept a legacy `false` on input, but migrate that field to `true`
|
|
152
|
+
* instead of invalidating the entire global config.
|
|
153
|
+
*/
|
|
154
|
+
llmCalls: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, true, boolean | undefined>;
|
|
155
|
+
}, "strip", z.ZodTypeAny, {
|
|
156
|
+
llmCalls: true;
|
|
157
|
+
turnSummaries: boolean;
|
|
158
|
+
}, {
|
|
159
|
+
llmCalls?: boolean | undefined;
|
|
160
|
+
turnSummaries?: boolean | undefined;
|
|
161
|
+
}>>;
|
|
162
|
+
otel: z.ZodDefault<z.ZodObject<{
|
|
163
|
+
logs: z.ZodDefault<z.ZodBoolean>;
|
|
164
|
+
traces: z.ZodDefault<z.ZodBoolean>;
|
|
165
|
+
metrics: z.ZodDefault<z.ZodBoolean>;
|
|
166
|
+
}, "strip", z.ZodTypeAny, {
|
|
167
|
+
logs: boolean;
|
|
168
|
+
traces: boolean;
|
|
169
|
+
metrics: boolean;
|
|
170
|
+
}, {
|
|
171
|
+
logs?: boolean | undefined;
|
|
172
|
+
traces?: boolean | undefined;
|
|
173
|
+
metrics?: boolean | undefined;
|
|
174
|
+
}>>;
|
|
175
|
+
delivery: z.ZodDefault<z.ZodObject<{
|
|
176
|
+
/** Budget for the in-hook direct send. Keep small: we are on the agent's critical path. */
|
|
177
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
178
|
+
/** How many queued events one drain pass may send. */
|
|
179
|
+
drainBatchSize: z.ZodDefault<z.ZodNumber>;
|
|
180
|
+
maxQueueEvents: z.ZodDefault<z.ZodNumber>;
|
|
181
|
+
maxAttempts: z.ZodDefault<z.ZodNumber>;
|
|
182
|
+
maxEventAgeDays: z.ZodDefault<z.ZodNumber>;
|
|
183
|
+
}, "strip", z.ZodTypeAny, {
|
|
184
|
+
timeoutMs: number;
|
|
185
|
+
drainBatchSize: number;
|
|
186
|
+
maxQueueEvents: number;
|
|
187
|
+
maxAttempts: number;
|
|
188
|
+
maxEventAgeDays: number;
|
|
189
|
+
}, {
|
|
190
|
+
timeoutMs?: number | undefined;
|
|
191
|
+
drainBatchSize?: number | undefined;
|
|
192
|
+
maxQueueEvents?: number | undefined;
|
|
193
|
+
maxAttempts?: number | undefined;
|
|
194
|
+
maxEventAgeDays?: number | undefined;
|
|
195
|
+
}>>;
|
|
196
|
+
enforcement: z.ZodDefault<z.ZodObject<{
|
|
197
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
198
|
+
/** Hard ceiling for the check; it sits between enter and the agent's first call. */
|
|
199
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
200
|
+
/** Mirrors the platform's own cache TTL for the same decision. */
|
|
201
|
+
cacheTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
202
|
+
}, "strip", z.ZodTypeAny, {
|
|
203
|
+
timeoutMs: number;
|
|
204
|
+
enabled: boolean;
|
|
205
|
+
cacheTtlMs: number;
|
|
206
|
+
}, {
|
|
207
|
+
timeoutMs?: number | undefined;
|
|
208
|
+
enabled?: boolean | undefined;
|
|
209
|
+
cacheTtlMs?: number | undefined;
|
|
210
|
+
}>>;
|
|
211
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
212
|
+
schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
|
|
213
|
+
/** Backend base URL, e.g. https://backend.example.com */
|
|
214
|
+
endpoint: z.ZodOptional<z.ZodString>;
|
|
215
|
+
/** Overrides; derived from endpoint when absent. */
|
|
216
|
+
eventsUrl: z.ZodOptional<z.ZodString>;
|
|
217
|
+
otlpUrl: z.ZodOptional<z.ZodString>;
|
|
218
|
+
enforcementUrl: z.ZodOptional<z.ZodString>;
|
|
219
|
+
token: z.ZodOptional<z.ZodString>;
|
|
220
|
+
installationId: z.ZodOptional<z.ZodString>;
|
|
221
|
+
/** Developer identity attached to turn summaries; falls back to `git config user.email`. */
|
|
222
|
+
developerEmail: z.ZodOptional<z.ZodString>;
|
|
223
|
+
capture: z.ZodDefault<z.ZodObject<{
|
|
224
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
225
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
226
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
227
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
228
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
229
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
230
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
231
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
232
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
233
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
234
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
235
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
236
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
237
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
238
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
239
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
240
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
241
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
242
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
243
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
244
|
+
}, z.ZodTypeAny, "passthrough">>>;
|
|
245
|
+
emit: z.ZodDefault<z.ZodObject<{
|
|
246
|
+
/** One flat summary per prompt→response turn, emitted on Stop. */
|
|
247
|
+
turnSummaries: z.ZodDefault<z.ZodBoolean>;
|
|
248
|
+
/**
|
|
249
|
+
* Every provider request is mandatory: it is the lossless usage ledger.
|
|
250
|
+
* Accept a legacy `false` on input, but migrate that field to `true`
|
|
251
|
+
* instead of invalidating the entire global config.
|
|
252
|
+
*/
|
|
253
|
+
llmCalls: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, true, boolean | undefined>;
|
|
254
|
+
}, "strip", z.ZodTypeAny, {
|
|
255
|
+
llmCalls: true;
|
|
256
|
+
turnSummaries: boolean;
|
|
257
|
+
}, {
|
|
258
|
+
llmCalls?: boolean | undefined;
|
|
259
|
+
turnSummaries?: boolean | undefined;
|
|
260
|
+
}>>;
|
|
261
|
+
otel: z.ZodDefault<z.ZodObject<{
|
|
262
|
+
logs: z.ZodDefault<z.ZodBoolean>;
|
|
263
|
+
traces: z.ZodDefault<z.ZodBoolean>;
|
|
264
|
+
metrics: z.ZodDefault<z.ZodBoolean>;
|
|
265
|
+
}, "strip", z.ZodTypeAny, {
|
|
266
|
+
logs: boolean;
|
|
267
|
+
traces: boolean;
|
|
268
|
+
metrics: boolean;
|
|
269
|
+
}, {
|
|
270
|
+
logs?: boolean | undefined;
|
|
271
|
+
traces?: boolean | undefined;
|
|
272
|
+
metrics?: boolean | undefined;
|
|
273
|
+
}>>;
|
|
274
|
+
delivery: z.ZodDefault<z.ZodObject<{
|
|
275
|
+
/** Budget for the in-hook direct send. Keep small: we are on the agent's critical path. */
|
|
276
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
277
|
+
/** How many queued events one drain pass may send. */
|
|
278
|
+
drainBatchSize: z.ZodDefault<z.ZodNumber>;
|
|
279
|
+
maxQueueEvents: z.ZodDefault<z.ZodNumber>;
|
|
280
|
+
maxAttempts: z.ZodDefault<z.ZodNumber>;
|
|
281
|
+
maxEventAgeDays: z.ZodDefault<z.ZodNumber>;
|
|
282
|
+
}, "strip", z.ZodTypeAny, {
|
|
283
|
+
timeoutMs: number;
|
|
284
|
+
drainBatchSize: number;
|
|
285
|
+
maxQueueEvents: number;
|
|
286
|
+
maxAttempts: number;
|
|
287
|
+
maxEventAgeDays: number;
|
|
288
|
+
}, {
|
|
289
|
+
timeoutMs?: number | undefined;
|
|
290
|
+
drainBatchSize?: number | undefined;
|
|
291
|
+
maxQueueEvents?: number | undefined;
|
|
292
|
+
maxAttempts?: number | undefined;
|
|
293
|
+
maxEventAgeDays?: number | undefined;
|
|
294
|
+
}>>;
|
|
295
|
+
enforcement: z.ZodDefault<z.ZodObject<{
|
|
296
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
297
|
+
/** Hard ceiling for the check; it sits between enter and the agent's first call. */
|
|
298
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
299
|
+
/** Mirrors the platform's own cache TTL for the same decision. */
|
|
300
|
+
cacheTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
301
|
+
}, "strip", z.ZodTypeAny, {
|
|
302
|
+
timeoutMs: number;
|
|
303
|
+
enabled: boolean;
|
|
304
|
+
cacheTtlMs: number;
|
|
305
|
+
}, {
|
|
306
|
+
timeoutMs?: number | undefined;
|
|
307
|
+
enabled?: boolean | undefined;
|
|
308
|
+
cacheTtlMs?: number | undefined;
|
|
309
|
+
}>>;
|
|
310
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
311
|
+
schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
|
|
312
|
+
/** Backend base URL, e.g. https://backend.example.com */
|
|
313
|
+
endpoint: z.ZodOptional<z.ZodString>;
|
|
314
|
+
/** Overrides; derived from endpoint when absent. */
|
|
315
|
+
eventsUrl: z.ZodOptional<z.ZodString>;
|
|
316
|
+
otlpUrl: z.ZodOptional<z.ZodString>;
|
|
317
|
+
enforcementUrl: z.ZodOptional<z.ZodString>;
|
|
318
|
+
token: z.ZodOptional<z.ZodString>;
|
|
319
|
+
installationId: z.ZodOptional<z.ZodString>;
|
|
320
|
+
/** Developer identity attached to turn summaries; falls back to `git config user.email`. */
|
|
321
|
+
developerEmail: z.ZodOptional<z.ZodString>;
|
|
322
|
+
capture: z.ZodDefault<z.ZodObject<{
|
|
323
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
324
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
325
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
326
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
327
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
328
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
329
|
+
}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
|
|
330
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
331
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
332
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
333
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
334
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
335
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
336
|
+
}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
|
|
337
|
+
prompts: z.ZodDefault<z.ZodBoolean>;
|
|
338
|
+
responses: z.ZodDefault<z.ZodBoolean>;
|
|
339
|
+
toolInput: z.ZodDefault<z.ZodBoolean>;
|
|
340
|
+
toolOutput: z.ZodDefault<z.ZodBoolean>;
|
|
341
|
+
git: z.ZodDefault<z.ZodBoolean>;
|
|
342
|
+
files: z.ZodDefault<z.ZodBoolean>;
|
|
343
|
+
}, z.ZodTypeAny, "passthrough">>>;
|
|
344
|
+
emit: z.ZodDefault<z.ZodObject<{
|
|
345
|
+
/** One flat summary per prompt→response turn, emitted on Stop. */
|
|
346
|
+
turnSummaries: z.ZodDefault<z.ZodBoolean>;
|
|
347
|
+
/**
|
|
348
|
+
* Every provider request is mandatory: it is the lossless usage ledger.
|
|
349
|
+
* Accept a legacy `false` on input, but migrate that field to `true`
|
|
350
|
+
* instead of invalidating the entire global config.
|
|
351
|
+
*/
|
|
352
|
+
llmCalls: z.ZodEffects<z.ZodDefault<z.ZodBoolean>, true, boolean | undefined>;
|
|
353
|
+
}, "strip", z.ZodTypeAny, {
|
|
354
|
+
llmCalls: true;
|
|
355
|
+
turnSummaries: boolean;
|
|
356
|
+
}, {
|
|
357
|
+
llmCalls?: boolean | undefined;
|
|
358
|
+
turnSummaries?: boolean | undefined;
|
|
359
|
+
}>>;
|
|
360
|
+
otel: z.ZodDefault<z.ZodObject<{
|
|
361
|
+
logs: z.ZodDefault<z.ZodBoolean>;
|
|
362
|
+
traces: z.ZodDefault<z.ZodBoolean>;
|
|
363
|
+
metrics: z.ZodDefault<z.ZodBoolean>;
|
|
364
|
+
}, "strip", z.ZodTypeAny, {
|
|
365
|
+
logs: boolean;
|
|
366
|
+
traces: boolean;
|
|
367
|
+
metrics: boolean;
|
|
368
|
+
}, {
|
|
369
|
+
logs?: boolean | undefined;
|
|
370
|
+
traces?: boolean | undefined;
|
|
371
|
+
metrics?: boolean | undefined;
|
|
372
|
+
}>>;
|
|
373
|
+
delivery: z.ZodDefault<z.ZodObject<{
|
|
374
|
+
/** Budget for the in-hook direct send. Keep small: we are on the agent's critical path. */
|
|
375
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
376
|
+
/** How many queued events one drain pass may send. */
|
|
377
|
+
drainBatchSize: z.ZodDefault<z.ZodNumber>;
|
|
378
|
+
maxQueueEvents: z.ZodDefault<z.ZodNumber>;
|
|
379
|
+
maxAttempts: z.ZodDefault<z.ZodNumber>;
|
|
380
|
+
maxEventAgeDays: z.ZodDefault<z.ZodNumber>;
|
|
381
|
+
}, "strip", z.ZodTypeAny, {
|
|
382
|
+
timeoutMs: number;
|
|
383
|
+
drainBatchSize: number;
|
|
384
|
+
maxQueueEvents: number;
|
|
385
|
+
maxAttempts: number;
|
|
386
|
+
maxEventAgeDays: number;
|
|
387
|
+
}, {
|
|
388
|
+
timeoutMs?: number | undefined;
|
|
389
|
+
drainBatchSize?: number | undefined;
|
|
390
|
+
maxQueueEvents?: number | undefined;
|
|
391
|
+
maxAttempts?: number | undefined;
|
|
392
|
+
maxEventAgeDays?: number | undefined;
|
|
393
|
+
}>>;
|
|
394
|
+
enforcement: z.ZodDefault<z.ZodObject<{
|
|
395
|
+
enabled: z.ZodDefault<z.ZodBoolean>;
|
|
396
|
+
/** Hard ceiling for the check; it sits between enter and the agent's first call. */
|
|
397
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
398
|
+
/** Mirrors the platform's own cache TTL for the same decision. */
|
|
399
|
+
cacheTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
400
|
+
}, "strip", z.ZodTypeAny, {
|
|
401
|
+
timeoutMs: number;
|
|
402
|
+
enabled: boolean;
|
|
403
|
+
cacheTtlMs: number;
|
|
404
|
+
}, {
|
|
405
|
+
timeoutMs?: number | undefined;
|
|
406
|
+
enabled?: boolean | undefined;
|
|
407
|
+
cacheTtlMs?: number | undefined;
|
|
408
|
+
}>>;
|
|
409
|
+
}, z.ZodTypeAny, "passthrough">>;
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { DEFAULT_DRAIN_BATCH_SIZE, DEFAULT_ENFORCEMENT_CACHE_TTL_MS, DEFAULT_ENFORCEMENT_TIMEOUT_MS, DEFAULT_MAX_ATTEMPTS, DEFAULT_MAX_EVENT_AGE_DAYS, DEFAULT_MAX_QUEUE_EVENTS, DEFAULT_SEND_TIMEOUT_MS } from '../constants/config.constants.js';
|
|
3
|
+
/**
|
|
4
|
+
* Everything is captured by default so the backend gets full turn context
|
|
5
|
+
* (prompts, responses, tool I/O, tokens); users opt out per field. Secrets are
|
|
6
|
+
* still scrubbed by the sanitizer regardless of these flags.
|
|
7
|
+
*/
|
|
8
|
+
export const captureSchema = z
|
|
9
|
+
.object({
|
|
10
|
+
prompts: z.boolean().default(true),
|
|
11
|
+
responses: z.boolean().default(true),
|
|
12
|
+
toolInput: z.boolean().default(true),
|
|
13
|
+
toolOutput: z.boolean().default(true),
|
|
14
|
+
git: z.boolean().default(true),
|
|
15
|
+
files: z.boolean().default(true)
|
|
16
|
+
})
|
|
17
|
+
.passthrough();
|
|
18
|
+
/** Tuning for the in-hook send and the machine-global offline queue. */
|
|
19
|
+
export const deliverySchema = z
|
|
20
|
+
.object({
|
|
21
|
+
/** Budget for the in-hook direct send. Keep small: we are on the agent's critical path. */
|
|
22
|
+
timeoutMs: z.number().int().positive().default(DEFAULT_SEND_TIMEOUT_MS),
|
|
23
|
+
/** How many queued events one drain pass may send. */
|
|
24
|
+
drainBatchSize: z.number().int().positive().default(DEFAULT_DRAIN_BATCH_SIZE),
|
|
25
|
+
maxQueueEvents: z.number().int().positive().default(DEFAULT_MAX_QUEUE_EVENTS),
|
|
26
|
+
maxAttempts: z.number().int().positive().default(DEFAULT_MAX_ATTEMPTS),
|
|
27
|
+
maxEventAgeDays: z.number().int().positive().default(DEFAULT_MAX_EVENT_AGE_DAYS)
|
|
28
|
+
})
|
|
29
|
+
.strip();
|
|
30
|
+
/**
|
|
31
|
+
* Which native OTLP signals agents export straight to the backend. Logs are
|
|
32
|
+
* the per-request usage/cost ledger the backend turns into llm.call — the
|
|
33
|
+
* default. Traces add latency/subagent spans, metrics add aggregate counters
|
|
34
|
+
* (cost, tokens, active time); both are off unless asked for.
|
|
35
|
+
*/
|
|
36
|
+
export const otelSchema = z
|
|
37
|
+
.object({
|
|
38
|
+
logs: z.boolean().default(true),
|
|
39
|
+
traces: z.boolean().default(false),
|
|
40
|
+
metrics: z.boolean().default(false)
|
|
41
|
+
})
|
|
42
|
+
.strip();
|
|
43
|
+
/**
|
|
44
|
+
* The pre-turn budget check.
|
|
45
|
+
*
|
|
46
|
+
* On by default: a cap a tenant marked `block` in the dashboard is meant to
|
|
47
|
+
* block, and a guardrail nobody switched on is the same notification nobody
|
|
48
|
+
* acted on. Only an explicit refusal from the platform ever stops a turn — see
|
|
49
|
+
* `src/enforcement/enforcement.ts` — so leaving it on costs a developer one
|
|
50
|
+
* bounded request per turn and nothing else.
|
|
51
|
+
*/
|
|
52
|
+
export const enforcementSchema = z
|
|
53
|
+
.object({
|
|
54
|
+
enabled: z.boolean().default(true),
|
|
55
|
+
/** Hard ceiling for the check; it sits between enter and the agent's first call. */
|
|
56
|
+
timeoutMs: z.number().int().positive().default(DEFAULT_ENFORCEMENT_TIMEOUT_MS),
|
|
57
|
+
/** Mirrors the platform's own cache TTL for the same decision. */
|
|
58
|
+
cacheTtlMs: z.number().int().positive().default(DEFAULT_ENFORCEMENT_CACHE_TTL_MS)
|
|
59
|
+
})
|
|
60
|
+
.strip();
|
|
61
|
+
/** Which records the edge itself emits. */
|
|
62
|
+
export const emitSchema = z
|
|
63
|
+
.object({
|
|
64
|
+
/** One flat summary per prompt→response turn, emitted on Stop. */
|
|
65
|
+
turnSummaries: z.boolean().default(true),
|
|
66
|
+
/**
|
|
67
|
+
* Every provider request is mandatory: it is the lossless usage ledger.
|
|
68
|
+
* Accept a legacy `false` on input, but migrate that field to `true`
|
|
69
|
+
* instead of invalidating the entire global config.
|
|
70
|
+
*/
|
|
71
|
+
llmCalls: z
|
|
72
|
+
.boolean()
|
|
73
|
+
.default(true)
|
|
74
|
+
.transform(() => true)
|
|
75
|
+
})
|
|
76
|
+
.strip();
|
|
77
|
+
/** The whole configuration file. Passthrough: forward compatibility. */
|
|
78
|
+
export const configSchema = z
|
|
79
|
+
.object({
|
|
80
|
+
schemaVersion: z.literal(1).default(1),
|
|
81
|
+
/** Backend base URL, e.g. https://backend.example.com */
|
|
82
|
+
endpoint: z.string().url().optional(),
|
|
83
|
+
/** Overrides; derived from endpoint when absent. */
|
|
84
|
+
eventsUrl: z.string().url().optional(),
|
|
85
|
+
otlpUrl: z.string().url().optional(),
|
|
86
|
+
enforcementUrl: z.string().url().optional(),
|
|
87
|
+
token: z.string().optional(),
|
|
88
|
+
installationId: z.string().optional(),
|
|
89
|
+
/** Developer identity attached to turn summaries; falls back to `git config user.email`. */
|
|
90
|
+
developerEmail: z.string().optional(),
|
|
91
|
+
capture: captureSchema.default({}),
|
|
92
|
+
emit: emitSchema.default({}),
|
|
93
|
+
otel: otelSchema.default({}),
|
|
94
|
+
delivery: deliverySchema.default({}),
|
|
95
|
+
enforcement: enforcementSchema.default({})
|
|
96
|
+
})
|
|
97
|
+
.passthrough();
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { z } from 'zod';
|
|
2
|
+
import type { captureSchema, configSchema, enforcementSchema, otelSchema } from '../schemas/config.schema.js';
|
|
3
|
+
export type CaptureConfig = z.infer<typeof captureSchema>;
|
|
4
|
+
export type OtelConfig = z.infer<typeof otelSchema>;
|
|
5
|
+
export type EnforcementConfig = z.infer<typeof enforcementSchema>;
|
|
6
|
+
export type AgentWatchConfig = z.infer<typeof configSchema>;
|
|
7
|
+
/** Name of one native OTLP signal. */
|
|
8
|
+
export type OtelSignalName = keyof OtelConfig;
|
|
9
|
+
/**
|
|
10
|
+
* Outcome of loading the global config. `missing` and `invalid` both carry a
|
|
11
|
+
* usable fallback: hooks must keep running with a broken config file, just
|
|
12
|
+
* with content capture off.
|
|
13
|
+
*/
|
|
14
|
+
export type ConfigLoadResult = {
|
|
15
|
+
readonly state: 'ok';
|
|
16
|
+
readonly config: AgentWatchConfig;
|
|
17
|
+
} | {
|
|
18
|
+
readonly state: 'missing';
|
|
19
|
+
readonly config: AgentWatchConfig;
|
|
20
|
+
} | {
|
|
21
|
+
readonly state: 'invalid';
|
|
22
|
+
readonly error: string;
|
|
23
|
+
readonly config: AgentWatchConfig;
|
|
24
|
+
};
|
|
25
|
+
/** A config with the repository overlay applied, and what was refused. */
|
|
26
|
+
export interface MergedConfig {
|
|
27
|
+
readonly config: AgentWatchConfig;
|
|
28
|
+
readonly warnings: readonly string[];
|
|
29
|
+
}
|
|
30
|
+
export interface EffectiveConfig extends MergedConfig {
|
|
31
|
+
/** Path of the applied repo overrides file, when one was found. */
|
|
32
|
+
readonly repoConfigFile?: string;
|
|
33
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolve after a delay.
|
|
3
|
+
*
|
|
4
|
+
* @param ms - Milliseconds to wait.
|
|
5
|
+
* @returns A promise that resolves once the timer fires.
|
|
6
|
+
*/
|
|
7
|
+
export declare function sleep(ms: number): Promise<void>;
|
|
8
|
+
/**
|
|
9
|
+
* Poll an acquire function until it hands something back or the deadline
|
|
10
|
+
* passes.
|
|
11
|
+
*
|
|
12
|
+
* The deadline is real time on purpose: callers inject a frozen clock in
|
|
13
|
+
* tests, and a frozen clock would make a wait loop spin forever.
|
|
14
|
+
*
|
|
15
|
+
* @param acquire - Attempt; returns the resource, or undefined to retry.
|
|
16
|
+
* @param maxWaitMs - Total budget for the whole wait.
|
|
17
|
+
* @param pollMs - Pause between attempts.
|
|
18
|
+
* @returns The resource, or undefined when the budget ran out.
|
|
19
|
+
*/
|
|
20
|
+
export declare function pollUntil<T>(acquire: () => Promise<T | undefined>, maxWaitMs: number, pollMs: number): Promise<T | undefined>;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolve after a delay.
|
|
3
|
+
*
|
|
4
|
+
* @param ms - Milliseconds to wait.
|
|
5
|
+
* @returns A promise that resolves once the timer fires.
|
|
6
|
+
*/
|
|
7
|
+
export function sleep(ms) {
|
|
8
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Poll an acquire function until it hands something back or the deadline
|
|
12
|
+
* passes.
|
|
13
|
+
*
|
|
14
|
+
* The deadline is real time on purpose: callers inject a frozen clock in
|
|
15
|
+
* tests, and a frozen clock would make a wait loop spin forever.
|
|
16
|
+
*
|
|
17
|
+
* @param acquire - Attempt; returns the resource, or undefined to retry.
|
|
18
|
+
* @param maxWaitMs - Total budget for the whole wait.
|
|
19
|
+
* @param pollMs - Pause between attempts.
|
|
20
|
+
* @returns The resource, or undefined when the budget ran out.
|
|
21
|
+
*/
|
|
22
|
+
export async function pollUntil(acquire, maxWaitMs, pollMs) {
|
|
23
|
+
const deadline = Date.now() + maxWaitMs;
|
|
24
|
+
for (;;) {
|
|
25
|
+
const acquired = await acquire();
|
|
26
|
+
if (acquired !== undefined)
|
|
27
|
+
return acquired;
|
|
28
|
+
if (Date.now() >= deadline)
|
|
29
|
+
return undefined;
|
|
30
|
+
await sleep(pollMs);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Module-level constants and pre-compiled patterns for the core module.
|
|
3
|
+
* Nothing here is built inside a function body (STYLEGUIDE 3.1).
|
|
4
|
+
*/
|
|
5
|
+
/** Prefix on every diagnostic line written to stderr. */
|
|
6
|
+
export declare const LOG_PREFIX = "[agentwatch]";
|
|
7
|
+
/** Environment variables that turn on debug logging. */
|
|
8
|
+
export declare const DEBUG_VAR = "AGENTWATCH_DEBUG";
|
|
9
|
+
export declare const DEBUG_NAMESPACE_VAR = "DEBUG";
|
|
10
|
+
export declare const DEBUG_NAMESPACE = "agentwatch";
|
|
11
|
+
/** Values of AGENTWATCH_DEBUG that mean "on". O(1) membership. */
|
|
12
|
+
export declare const TRUTHY_DEBUG_VALUES: Set<string>;
|
|
13
|
+
/** First dotted version in arbitrary CLI output. */
|
|
14
|
+
export declare const RE_SEMVER: RegExp;
|
|
15
|
+
/** Executable extensions probed on Windows, in resolution order. */
|
|
16
|
+
export declare const WINDOWS_EXECUTABLE_EXTENSIONS: readonly [".exe", ".cmd", ".bat"];
|
|
17
|
+
/** Any of these bits set means "executable by someone" on POSIX. */
|
|
18
|
+
export declare const POSIX_EXECUTABLE_MASK = 73;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Module-level constants and pre-compiled patterns for the core module.
|
|
3
|
+
* Nothing here is built inside a function body (STYLEGUIDE 3.1).
|
|
4
|
+
*/
|
|
5
|
+
/** Prefix on every diagnostic line written to stderr. */
|
|
6
|
+
export const LOG_PREFIX = '[agentwatch]';
|
|
7
|
+
/** Environment variables that turn on debug logging. */
|
|
8
|
+
export const DEBUG_VAR = 'AGENTWATCH_DEBUG';
|
|
9
|
+
export const DEBUG_NAMESPACE_VAR = 'DEBUG';
|
|
10
|
+
export const DEBUG_NAMESPACE = 'agentwatch';
|
|
11
|
+
/** Values of AGENTWATCH_DEBUG that mean "on". O(1) membership. */
|
|
12
|
+
export const TRUTHY_DEBUG_VALUES = new Set(['1', 'true']);
|
|
13
|
+
/** First dotted version in arbitrary CLI output. */
|
|
14
|
+
export const RE_SEMVER = /\d+\.\d+\.\d+/;
|
|
15
|
+
/** Executable extensions probed on Windows, in resolution order. */
|
|
16
|
+
export const WINDOWS_EXECUTABLE_EXTENSIONS = ['.exe', '.cmd', '.bat'];
|
|
17
|
+
/** Any of these bits set means "executable by someone" on POSIX. */
|
|
18
|
+
export const POSIX_EXECUTABLE_MASK = 0o111;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Env } from './types/core.types.js';
|
|
2
|
+
export type { Env } from './types/core.types.js';
|
|
3
|
+
/**
|
|
4
|
+
* The real process environment.
|
|
5
|
+
*
|
|
6
|
+
* The single place the package reads ambient state from. Everything
|
|
7
|
+
* downstream takes an `Env` argument instead, which is what lets the test
|
|
8
|
+
* suite run every command against a temporary HOME.
|
|
9
|
+
*
|
|
10
|
+
* @returns An Env bound to this process.
|
|
11
|
+
*/
|
|
12
|
+
export declare function realEnv(): Env;
|
package/dist/core/env.js
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import os from 'node:os';
|
|
2
|
+
import process from 'node:process';
|
|
3
|
+
/**
|
|
4
|
+
* The real process environment.
|
|
5
|
+
*
|
|
6
|
+
* The single place the package reads ambient state from. Everything
|
|
7
|
+
* downstream takes an `Env` argument instead, which is what lets the test
|
|
8
|
+
* suite run every command against a temporary HOME.
|
|
9
|
+
*
|
|
10
|
+
* @returns An Env bound to this process.
|
|
11
|
+
*/
|
|
12
|
+
export function realEnv() {
|
|
13
|
+
return {
|
|
14
|
+
home: os.homedir(),
|
|
15
|
+
platform: process.platform,
|
|
16
|
+
cwd: process.cwd(),
|
|
17
|
+
vars: process.env,
|
|
18
|
+
now: () => new Date()
|
|
19
|
+
};
|
|
20
|
+
}
|