@itphx/synth-shared 0.10.1 → 0.11.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/config/defaults.js +49 -3
  2. package/dist/config/env-overrides.d.ts +4 -1
  3. package/dist/config/env-overrides.js +37 -4
  4. package/dist/config/index.d.ts +3 -0
  5. package/dist/config/index.js +3 -0
  6. package/dist/config/loader.js +19 -0
  7. package/dist/config/proxy.d.ts +415 -0
  8. package/dist/config/proxy.js +1565 -0
  9. package/dist/config/resolve.d.ts +67 -0
  10. package/dist/config/resolve.js +187 -1
  11. package/dist/config/tls-runtime.d.ts +78 -0
  12. package/dist/config/tls-runtime.js +356 -0
  13. package/dist/config/tls.d.ts +215 -0
  14. package/dist/config/tls.js +394 -0
  15. package/dist/config/types.d.ts +1536 -50
  16. package/dist/config/types.js +273 -7
  17. package/dist/i18n/index.d.ts +1 -1
  18. package/dist/i18n/index.js +2 -0
  19. package/dist/index.d.ts +11 -2
  20. package/dist/index.js +11 -2
  21. package/dist/protocols/index.d.ts +0 -1
  22. package/dist/schemas/index.d.ts +134 -9
  23. package/dist/schemas/index.js +51 -4
  24. package/dist/types/analytics.d.ts +113 -0
  25. package/dist/types/analytics.js +61 -0
  26. package/dist/types/egress.d.ts +114 -0
  27. package/dist/types/egress.js +68 -0
  28. package/dist/types/events.d.ts +0 -1
  29. package/dist/types/fs.d.ts +11 -0
  30. package/dist/types/fs.js +11 -0
  31. package/dist/types/hooks.d.ts +20 -0
  32. package/dist/types/index.d.ts +3 -0
  33. package/dist/types/index.js +6 -0
  34. package/dist/types/maintenance.d.ts +39 -0
  35. package/dist/types/maintenance.js +11 -0
  36. package/dist/types/mcp.d.ts +68 -3
  37. package/dist/types/mcp.js +83 -4
  38. package/dist/types/permission.d.ts +7 -5
  39. package/dist/types/prompt.d.ts +3 -2
  40. package/dist/types/session.d.ts +0 -1
  41. package/dist/types/webhooks.d.ts +1 -1
  42. package/dist/utils/index.d.ts +15 -0
  43. package/dist/utils/index.js +53 -0
  44. package/dist/version.d.ts +1 -1
  45. package/dist/version.js +1 -1
  46. package/package.json +1 -1
@@ -130,7 +130,6 @@ export declare const sessionCreateSchema: z.ZodObject<{
130
130
  icon: z.ZodNullable<z.ZodOptional<z.ZodEnum<["code", "terminal", "rocket", "flask", "gamepad", "briefcase", "home", "globe", "leaf", "shield", "palette", "server", "phone", "database", "lightbulb", "music", "camera", "book", "heart", "folder", "chat", "cpu", "file", "file-code", "docs", "task", "todo", "bug", "robot", "brain", "git", "repo", "test", "chart", "star", "image", "calendar"]>>>;
131
131
  color: z.ZodNullable<z.ZodOptional<z.ZodEnum<["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9", "a10", "a11", "a12", "a13", "a14", "a15", "a16"]>>>;
132
132
  projectId: z.ZodOptional<z.ZodString>;
133
- engine: z.ZodDefault<z.ZodEnum<["synth", "opencode", "cline"]>>;
134
133
  settings: z.ZodOptional<z.ZodObject<{
135
134
  provider: z.ZodOptional<z.ZodString>;
136
135
  model: z.ZodOptional<z.ZodString>;
@@ -221,7 +220,6 @@ export declare const sessionCreateSchema: z.ZodObject<{
221
220
  decisionFirst?: boolean | undefined;
222
221
  }>>;
223
222
  }, "strip", z.ZodTypeAny, {
224
- engine: "synth" | "opencode" | "cline";
225
223
  name?: string | undefined;
226
224
  title?: string | undefined;
227
225
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | null | undefined;
@@ -263,7 +261,6 @@ export declare const sessionCreateSchema: z.ZodObject<{
263
261
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | null | undefined;
264
262
  color?: "a1" | "a2" | "a3" | "a4" | "a5" | "a6" | "a7" | "a8" | "a9" | "a10" | "a11" | "a12" | "a13" | "a14" | "a15" | "a16" | null | undefined;
265
263
  projectId?: string | undefined;
266
- engine?: "synth" | "opencode" | "cline" | undefined;
267
264
  settings?: {
268
265
  provider?: string | undefined;
269
266
  model?: string | undefined;
@@ -300,7 +297,6 @@ export declare const sessionUpdateSchema: z.ZodObject<{
300
297
  icon: z.ZodNullable<z.ZodOptional<z.ZodEnum<["code", "terminal", "rocket", "flask", "gamepad", "briefcase", "home", "globe", "leaf", "shield", "palette", "server", "phone", "database", "lightbulb", "music", "camera", "book", "heart", "folder", "chat", "cpu", "file", "file-code", "docs", "task", "todo", "bug", "robot", "brain", "git", "repo", "test", "chart", "star", "image", "calendar"]>>>;
301
298
  color: z.ZodNullable<z.ZodOptional<z.ZodEnum<["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9", "a10", "a11", "a12", "a13", "a14", "a15", "a16"]>>>;
302
299
  projectId: z.ZodOptional<z.ZodString>;
303
- engine: z.ZodOptional<z.ZodEnum<["synth", "opencode", "cline"]>>;
304
300
  settings: z.ZodOptional<z.ZodObject<{
305
301
  provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
306
302
  model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -394,7 +390,6 @@ export declare const sessionUpdateSchema: z.ZodObject<{
394
390
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | null | undefined;
395
391
  color?: "a1" | "a2" | "a3" | "a4" | "a5" | "a6" | "a7" | "a8" | "a9" | "a10" | "a11" | "a12" | "a13" | "a14" | "a15" | "a16" | null | undefined;
396
392
  projectId?: string | undefined;
397
- engine?: "synth" | "opencode" | "cline" | undefined;
398
393
  settings?: z.objectOutputType<{
399
394
  provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
400
395
  model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -430,7 +425,6 @@ export declare const sessionUpdateSchema: z.ZodObject<{
430
425
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | null | undefined;
431
426
  color?: "a1" | "a2" | "a3" | "a4" | "a5" | "a6" | "a7" | "a8" | "a9" | "a10" | "a11" | "a12" | "a13" | "a14" | "a15" | "a16" | null | undefined;
432
427
  projectId?: string | undefined;
433
- engine?: "synth" | "opencode" | "cline" | undefined;
434
428
  settings?: z.objectInputType<{
435
429
  provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
436
430
  model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -1426,7 +1420,6 @@ export declare const sessionRequestSchema: z.ZodObject<{
1426
1420
  title: z.ZodOptional<z.ZodString>;
1427
1421
  icon: z.ZodOptional<z.ZodEnum<["code", "terminal", "rocket", "flask", "gamepad", "briefcase", "home", "globe", "leaf", "shield", "palette", "server", "phone", "database", "lightbulb", "music", "camera", "book", "heart", "folder", "chat", "cpu", "file", "file-code", "docs", "task", "todo", "bug", "robot", "brain", "git", "repo", "test", "chart", "star", "image", "calendar"]>>;
1428
1422
  color: z.ZodOptional<z.ZodEnum<["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9", "a10", "a11", "a12", "a13", "a14", "a15", "a16"]>>;
1429
- engine: z.ZodOptional<z.ZodEnum<["synth", "opencode", "cline"]>>;
1430
1423
  sessionOrigin: z.ZodOptional<z.ZodEnum<["user", "fork", "subagent"]>>;
1431
1424
  settings: z.ZodOptional<z.ZodUnknown>;
1432
1425
  sourceEventId: z.ZodOptional<z.ZodString>;
@@ -1439,7 +1432,6 @@ export declare const sessionRequestSchema: z.ZodObject<{
1439
1432
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | undefined;
1440
1433
  color?: "a1" | "a2" | "a3" | "a4" | "a5" | "a6" | "a7" | "a8" | "a9" | "a10" | "a11" | "a12" | "a13" | "a14" | "a15" | "a16" | undefined;
1441
1434
  projectId?: string | undefined;
1442
- engine?: "synth" | "opencode" | "cline" | undefined;
1443
1435
  settings?: unknown;
1444
1436
  dedupKey?: string | undefined;
1445
1437
  agentTemplate?: string | undefined;
@@ -1455,7 +1447,6 @@ export declare const sessionRequestSchema: z.ZodObject<{
1455
1447
  icon?: "code" | "chat" | "task" | "terminal" | "rocket" | "flask" | "gamepad" | "briefcase" | "home" | "globe" | "leaf" | "shield" | "palette" | "server" | "phone" | "database" | "lightbulb" | "music" | "camera" | "book" | "heart" | "folder" | "cpu" | "file" | "file-code" | "docs" | "todo" | "bug" | "robot" | "brain" | "git" | "repo" | "test" | "chart" | "star" | "image" | "calendar" | undefined;
1456
1448
  color?: "a1" | "a2" | "a3" | "a4" | "a5" | "a6" | "a7" | "a8" | "a9" | "a10" | "a11" | "a12" | "a13" | "a14" | "a15" | "a16" | undefined;
1457
1449
  projectId?: string | undefined;
1458
- engine?: "synth" | "opencode" | "cline" | undefined;
1459
1450
  settings?: unknown;
1460
1451
  dedupKey?: string | undefined;
1461
1452
  agentTemplate?: string | undefined;
@@ -2980,3 +2971,137 @@ export declare const scheduleJobSchema: z.ZodObject<{
2980
2971
  reason?: string | undefined;
2981
2972
  }>;
2982
2973
  export type ScheduleJobRequest = z.infer<typeof scheduleJobSchema>;
2974
+ /** PROP-102: семейство роллапов аналитики (`usage`/`activity`/`decision`/`prompt`). */
2975
+ export declare const analyticsFamilySchema: z.ZodEnum<["usage", "activity", "decision", "prompt"]>;
2976
+ /** PROP-102: ось измерения роллапа (`day`/`user`/`project`/`model`/`agent`/`provider`). */
2977
+ export declare const analyticsDimensionSchema: z.ZodEnum<["day", "user", "project", "model", "agent", "provider"]>;
2978
+ /** PROP-102: сутки UTC в формате `YYYY-MM-DD`. */
2979
+ export declare const analyticsDaySchema: z.ZodString;
2980
+ /** PROP-102: пред-агрегированный бакет роллапа (запись через порт хранения). */
2981
+ export declare const analyticsRollupBucketSchema: z.ZodObject<{
2982
+ family: z.ZodEnum<["usage", "activity", "decision", "prompt"]>;
2983
+ day: z.ZodString;
2984
+ dimensions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
2985
+ measures: z.ZodRecord<z.ZodString, z.ZodNumber>;
2986
+ costByCurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
2987
+ }, "strip", z.ZodTypeAny, {
2988
+ day: string;
2989
+ family: "prompt" | "decision" | "usage" | "activity";
2990
+ dimensions: Record<string, string>;
2991
+ measures: Record<string, number>;
2992
+ costByCurrency?: Record<string, number> | undefined;
2993
+ }, {
2994
+ day: string;
2995
+ family: "prompt" | "decision" | "usage" | "activity";
2996
+ measures: Record<string, number>;
2997
+ dimensions?: Record<string, string> | undefined;
2998
+ costByCurrency?: Record<string, number> | undefined;
2999
+ }>;
3000
+ /** PROP-102: запрос среза/серии роллапов (только чтение). */
3001
+ export declare const analyticsRollupQuerySchema: z.ZodObject<{
3002
+ family: z.ZodEnum<["usage", "activity", "decision", "prompt"]>;
3003
+ from: z.ZodOptional<z.ZodString>;
3004
+ to: z.ZodOptional<z.ZodString>;
3005
+ dimensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3006
+ groupBy: z.ZodOptional<z.ZodArray<z.ZodEnum<["day", "user", "project", "model", "agent", "provider"]>, "many">>;
3007
+ }, "strip", z.ZodTypeAny, {
3008
+ family: "prompt" | "decision" | "usage" | "activity";
3009
+ dimensions?: Record<string, string> | undefined;
3010
+ from?: string | undefined;
3011
+ to?: string | undefined;
3012
+ groupBy?: ("user" | "provider" | "model" | "agent" | "project" | "day")[] | undefined;
3013
+ }, {
3014
+ family: "prompt" | "decision" | "usage" | "activity";
3015
+ dimensions?: Record<string, string> | undefined;
3016
+ from?: string | undefined;
3017
+ to?: string | undefined;
3018
+ groupBy?: ("user" | "provider" | "model" | "agent" | "project" | "day")[] | undefined;
3019
+ }>;
3020
+ export type AnalyticsRollupBucketInput = z.infer<typeof analyticsRollupBucketSchema>;
3021
+ export type AnalyticsRollupQueryInput = z.infer<typeof analyticsRollupQuerySchema>;
3022
+ /**
3023
+ * PROP-102: строка отчёта — оси группировки + меры (сырые счётчики и
3024
+ * дериваты `ANALYTICS_DERIVED_MEASURES`). `costByCurrency` опускается, если пусто.
3025
+ */
3026
+ export declare const analyticsReportRowSchema: z.ZodObject<{
3027
+ dimensions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
3028
+ measures: z.ZodRecord<z.ZodString, z.ZodNumber>;
3029
+ costByCurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
3030
+ }, "strip", z.ZodTypeAny, {
3031
+ dimensions: Record<string, string>;
3032
+ measures: Record<string, number>;
3033
+ costByCurrency?: Record<string, number> | undefined;
3034
+ }, {
3035
+ measures: Record<string, number>;
3036
+ dimensions?: Record<string, string> | undefined;
3037
+ costByCurrency?: Record<string, number> | undefined;
3038
+ }>;
3039
+ /** PROP-102: отчёт по семейству за период (только чтение, данные без i18n). */
3040
+ export declare const analyticsReportSchema: z.ZodObject<{
3041
+ report: z.ZodEnum<["usage", "activity", "decision", "prompt"]>;
3042
+ from: z.ZodString;
3043
+ to: z.ZodString;
3044
+ groupBy: z.ZodArray<z.ZodEnum<["day", "user", "project", "model", "agent", "provider"]>, "many">;
3045
+ rows: z.ZodArray<z.ZodObject<{
3046
+ dimensions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
3047
+ measures: z.ZodRecord<z.ZodString, z.ZodNumber>;
3048
+ costByCurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
3049
+ }, "strip", z.ZodTypeAny, {
3050
+ dimensions: Record<string, string>;
3051
+ measures: Record<string, number>;
3052
+ costByCurrency?: Record<string, number> | undefined;
3053
+ }, {
3054
+ measures: Record<string, number>;
3055
+ dimensions?: Record<string, string> | undefined;
3056
+ costByCurrency?: Record<string, number> | undefined;
3057
+ }>, "many">;
3058
+ }, "strip", z.ZodTypeAny, {
3059
+ from: string;
3060
+ to: string;
3061
+ groupBy: ("user" | "provider" | "model" | "agent" | "project" | "day")[];
3062
+ report: "prompt" | "decision" | "usage" | "activity";
3063
+ rows: {
3064
+ dimensions: Record<string, string>;
3065
+ measures: Record<string, number>;
3066
+ costByCurrency?: Record<string, number> | undefined;
3067
+ }[];
3068
+ }, {
3069
+ from: string;
3070
+ to: string;
3071
+ groupBy: ("user" | "provider" | "model" | "agent" | "project" | "day")[];
3072
+ report: "prompt" | "decision" | "usage" | "activity";
3073
+ rows: {
3074
+ measures: Record<string, number>;
3075
+ dimensions?: Record<string, string> | undefined;
3076
+ costByCurrency?: Record<string, number> | undefined;
3077
+ }[];
3078
+ }>;
3079
+ /** PROP-102: формат выгрузки отчёта (`csv`/`json`; только данные). */
3080
+ export declare const analyticsExportFormatSchema: z.ZodEnum<["csv", "json"]>;
3081
+ /** PROP-102: сводка инстанса за период — агрегаты `usage`/`activity`/`decision`. */
3082
+ export declare const analyticsSummarySchema: z.ZodObject<{
3083
+ from: z.ZodString;
3084
+ to: z.ZodString;
3085
+ usage: z.ZodRecord<z.ZodString, z.ZodNumber>;
3086
+ activity: z.ZodRecord<z.ZodString, z.ZodNumber>;
3087
+ decision: z.ZodRecord<z.ZodString, z.ZodNumber>;
3088
+ costByCurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
3089
+ }, "strip", z.ZodTypeAny, {
3090
+ decision: Record<string, number>;
3091
+ usage: Record<string, number>;
3092
+ activity: Record<string, number>;
3093
+ from: string;
3094
+ to: string;
3095
+ costByCurrency?: Record<string, number> | undefined;
3096
+ }, {
3097
+ decision: Record<string, number>;
3098
+ usage: Record<string, number>;
3099
+ activity: Record<string, number>;
3100
+ from: string;
3101
+ to: string;
3102
+ costByCurrency?: Record<string, number> | undefined;
3103
+ }>;
3104
+ export type AnalyticsReportRowInput = z.infer<typeof analyticsReportRowSchema>;
3105
+ export type AnalyticsReportInput = z.infer<typeof analyticsReportSchema>;
3106
+ export type AnalyticsExportFormatInput = z.infer<typeof analyticsExportFormatSchema>;
3107
+ export type AnalyticsSummaryInput = z.infer<typeof analyticsSummarySchema>;
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, } from '../types/index.js';
2
+ import { MessageRole, GlobalRole, ProjectRole, StatusMessageType, PROJECT_ICON_KEYS, PROJECT_COLOR_KEYS, isKnownScope, isWebhookEventPattern, ANALYTICS_FAMILIES, ANALYTICS_DIMENSIONS, ANALYTICS_EXPORT_FORMATS, } from '../types/index.js';
3
3
  import { ToolCapability } from '../types/tools.js';
4
4
  export const messageRoleSchema = z.nativeEnum(MessageRole);
5
5
  export const globalRoleSchema = z.nativeEnum(GlobalRole);
@@ -76,7 +76,6 @@ export const sessionCreateSchema = z.object({
76
76
  icon: projectIconKeySchema.optional().nullable(),
77
77
  color: projectColorKeySchema.optional().nullable(),
78
78
  projectId: z.string().optional(),
79
- engine: z.enum(['synth', 'opencode', 'cline']).default('synth'),
80
79
  settings: sessionSettingsSchema.optional(),
81
80
  });
82
81
  export const sessionUpdateSchema = z.object({
@@ -84,7 +83,6 @@ export const sessionUpdateSchema = z.object({
84
83
  icon: projectIconKeySchema.optional().nullable(),
85
84
  color: projectColorKeySchema.optional().nullable(),
86
85
  projectId: z.string().optional(),
87
- engine: z.enum(['synth', 'opencode', 'cline']).optional(),
88
86
  // passthrough: настройки сессии содержат поля вне sessionSettingsSchema
89
87
  // (mcpServers, routing*, microFirst, embedding*, permission, mcpToolSettings, llmGateway),
90
88
  // их нельзя терять при PATCH — известные поля валидируются, неизвестные пропускаются.
@@ -464,7 +462,6 @@ export const sessionRequestSchema = z.object({
464
462
  title: z.string().optional(),
465
463
  icon: projectIconKeySchema.optional(),
466
464
  color: projectColorKeySchema.optional(),
467
- engine: z.enum(['synth', 'opencode', 'cline']).optional(),
468
465
  sessionOrigin: z.enum(['user', 'fork', 'subagent']).optional(),
469
466
  // Настройки сессии валидируются собственной схемой при создании; здесь —
470
467
  // толерантный контейнер, чтобы не дублировать SessionSettings.
@@ -792,3 +789,53 @@ export const scheduleJobSchema = z.object({
792
789
  sessionId: z.string().optional(),
793
790
  error: z.string().optional(),
794
791
  });
792
+ /** PROP-102: семейство роллапов аналитики (`usage`/`activity`/`decision`/`prompt`). */
793
+ export const analyticsFamilySchema = z.enum(ANALYTICS_FAMILIES);
794
+ /** PROP-102: ось измерения роллапа (`day`/`user`/`project`/`model`/`agent`/`provider`). */
795
+ export const analyticsDimensionSchema = z.enum(ANALYTICS_DIMENSIONS);
796
+ /** PROP-102: сутки UTC в формате `YYYY-MM-DD`. */
797
+ export const analyticsDaySchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
798
+ /** PROP-102: пред-агрегированный бакет роллапа (запись через порт хранения). */
799
+ export const analyticsRollupBucketSchema = z.object({
800
+ family: analyticsFamilySchema,
801
+ day: analyticsDaySchema,
802
+ dimensions: z.record(z.string(), z.string()).default({}),
803
+ measures: z.record(z.string(), z.number()),
804
+ costByCurrency: z.record(z.string(), z.number()).optional(),
805
+ });
806
+ /** PROP-102: запрос среза/серии роллапов (только чтение). */
807
+ export const analyticsRollupQuerySchema = z.object({
808
+ family: analyticsFamilySchema,
809
+ from: analyticsDaySchema.optional(),
810
+ to: analyticsDaySchema.optional(),
811
+ dimensions: z.record(z.string(), z.string()).optional(),
812
+ groupBy: z.array(analyticsDimensionSchema).optional(),
813
+ });
814
+ /**
815
+ * PROP-102: строка отчёта — оси группировки + меры (сырые счётчики и
816
+ * дериваты `ANALYTICS_DERIVED_MEASURES`). `costByCurrency` опускается, если пусто.
817
+ */
818
+ export const analyticsReportRowSchema = z.object({
819
+ dimensions: z.record(z.string(), z.string()).default({}),
820
+ measures: z.record(z.string(), z.number()),
821
+ costByCurrency: z.record(z.string(), z.number()).optional(),
822
+ });
823
+ /** PROP-102: отчёт по семейству за период (только чтение, данные без i18n). */
824
+ export const analyticsReportSchema = z.object({
825
+ report: analyticsFamilySchema,
826
+ from: analyticsDaySchema,
827
+ to: analyticsDaySchema,
828
+ groupBy: z.array(analyticsDimensionSchema),
829
+ rows: z.array(analyticsReportRowSchema),
830
+ });
831
+ /** PROP-102: формат выгрузки отчёта (`csv`/`json`; только данные). */
832
+ export const analyticsExportFormatSchema = z.enum(ANALYTICS_EXPORT_FORMATS);
833
+ /** PROP-102: сводка инстанса за период — агрегаты `usage`/`activity`/`decision`. */
834
+ export const analyticsSummarySchema = z.object({
835
+ from: analyticsDaySchema,
836
+ to: analyticsDaySchema,
837
+ usage: z.record(z.string(), z.number()),
838
+ activity: z.record(z.string(), z.number()),
839
+ decision: z.record(z.string(), z.number()),
840
+ costByCurrency: z.record(z.string(), z.number()).optional(),
841
+ });
@@ -0,0 +1,113 @@
1
+ /**
2
+ * PROP-102: аналитика и отчётность инстанса — контракт пред-агрегированных
3
+ * суточных роллапов.
4
+ *
5
+ * Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
6
+ * (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
7
+ * итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
8
+ * сообщений, содержимого промптов, ключей и PII в значениях нет.
9
+ */
10
+ /** Семейства роллапов (PROP-102 §2). */
11
+ export declare const ANALYTICS_FAMILIES: readonly ["usage", "activity", "decision", "prompt"];
12
+ export type AnalyticsFamily = (typeof ANALYTICS_FAMILIES)[number];
13
+ /**
14
+ * Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
15
+ * бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
16
+ */
17
+ export declare const ANALYTICS_DIMENSIONS: readonly ["day", "user", "project", "model", "agent", "provider"];
18
+ export type AnalyticsDimension = (typeof ANALYTICS_DIMENSIONS)[number];
19
+ /**
20
+ * Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
21
+ * `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
22
+ * уровня домена: хранилище неизвестные числовые меры не отбрасывает.
23
+ */
24
+ export declare const ANALYTICS_MEASURES_BY_FAMILY: {
25
+ readonly usage: readonly ["input_tokens", "output_tokens", "cache_read_tokens", "cache_write_tokens", "reasoning_tokens", "requests", "messages", "duration_ms"];
26
+ readonly activity: readonly ["sessions_created", "sessions_archived", "messages_user", "messages_assistant", "messages_tool", "tool_calls", "errors", "aborts", "turns"];
27
+ readonly decision: readonly ["calls", "handled", "fallback", "escalated", "attempts", "rejected"];
28
+ readonly prompt: readonly [];
29
+ };
30
+ /**
31
+ * Пред-агрегированный бакет роллапа. Ключ — `(family, day, dimensions)`
32
+ * (измерения в отсортированном порядке). `increment` — upsert с суммированием,
33
+ * `set` — точная перезапись.
34
+ */
35
+ export interface AnalyticsRollupBucket {
36
+ family: AnalyticsFamily;
37
+ /** Сутки UTC в формате `YYYY-MM-DD`. */
38
+ day: string;
39
+ /** Значения осей (короткие ключи `AnalyticsDimension`); `day` — отдельное поле. */
40
+ dimensions: Record<string, string>;
41
+ /** Сырые счётчики (snake_case); неизвестные меры сохраняются как есть. */
42
+ measures: Record<string, number>;
43
+ /** Разбивка стоимости по валютам; пустая — поле опускается. */
44
+ costByCurrency?: Record<string, number>;
45
+ }
46
+ /** Запрос среза/серии роллапов: фильтры (семейство/период/оси) + группировка. */
47
+ export interface AnalyticsRollupQuery {
48
+ family: AnalyticsFamily;
49
+ /** Начало периода включительно (`YYYY-MM-DD`, сравнение по строке). */
50
+ from?: string;
51
+ /** Конец периода включительно (`YYYY-MM-DD`). */
52
+ to?: string;
53
+ /** Фильтр по равенству значений осей; для `day` — сравнение с `bucket.day`. */
54
+ dimensions?: Partial<Record<AnalyticsDimension, string>>;
55
+ /** Оси группировки; пусто/не задано — одна итоговая строка (`dimensions: {}`). */
56
+ groupBy?: AnalyticsDimension[];
57
+ }
58
+ /** Строка агрегированного ответа: значения осей группировки + суммы мер. */
59
+ export interface AnalyticsRollupRow {
60
+ /** Значения осей группировки (пусто — итог). */
61
+ dimensions: Record<string, string>;
62
+ measures: Record<string, number>;
63
+ /** Разбивка стоимости по валютам; пустая — поле опускается. */
64
+ costByCurrency?: Record<string, number>;
65
+ }
66
+ /**
67
+ * Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
68
+ * персистятся, PROP-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
69
+ * экспорте выносятся отдельными колонками после сырых мер.
70
+ */
71
+ export declare const ANALYTICS_DERIVED_MEASURES: readonly ["total_tokens", "cache_hit_rate", "reasoning_ratio", "output_tps"];
72
+ export type AnalyticsDerivedMeasure = (typeof ANALYTICS_DERIVED_MEASURES)[number];
73
+ /** Идентификатор отчёта — совпадает с семейством роллапов (PROP-102 §4). */
74
+ export type AnalyticsReportKind = AnalyticsFamily;
75
+ /** Строка отчёта: оси группировки + меры (в т.ч. дериваты) + стоимость. */
76
+ export interface AnalyticsReportRow {
77
+ /** Значения осей группировки (пусто — итог). */
78
+ dimensions: Record<string, string>;
79
+ /** Меры: сырые счётчики + дериваты (`ANALYTICS_DERIVED_MEASURES`). */
80
+ measures: Record<string, number>;
81
+ /** Разбивка стоимости по валютам; пустая — поле опускается. */
82
+ costByCurrency?: Record<string, number>;
83
+ }
84
+ /** Отчёт по семейству за период (только чтение, PROP-102 §4). */
85
+ export interface AnalyticsReport {
86
+ report: AnalyticsReportKind;
87
+ /** Начало периода включительно (`YYYY-MM-DD`, UTC). */
88
+ from: string;
89
+ /** Конец периода включительно (`YYYY-MM-DD`, UTC). */
90
+ to: string;
91
+ /** Оси группировки (порядок важен для экспорта). */
92
+ groupBy: AnalyticsDimension[];
93
+ rows: AnalyticsReportRow[];
94
+ }
95
+ /** Формат выгрузки отчёта (server-side, только данные — PROP-102 §6). */
96
+ export declare const ANALYTICS_EXPORT_FORMATS: readonly ["csv", "json"];
97
+ export type AnalyticsExportFormat = (typeof ANALYTICS_EXPORT_FORMATS)[number];
98
+ /**
99
+ * Сводка инстанса за период: агрегаты по семействам (меры usage с дериватами,
100
+ * меры activity и decision — своими словарями). Без персональных данных.
101
+ */
102
+ export interface AnalyticsSummary {
103
+ from: string;
104
+ to: string;
105
+ /** Меры `usage` (в т.ч. дериваты) — итог по периоду. */
106
+ usage: Record<string, number>;
107
+ /** Меры `activity` — итог по периоду. */
108
+ activity: Record<string, number>;
109
+ /** Меры `decision` — итог по периоду. */
110
+ decision: Record<string, number>;
111
+ /** Итоговая стоимость по валютам; пустая — поле опускается. */
112
+ costByCurrency?: Record<string, number>;
113
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * PROP-102: аналитика и отчётность инстанса — контракт пред-агрегированных
3
+ * суточных роллапов.
4
+ *
5
+ * Единица роллапа — **сутки в UTC**. Хранилище держит **сырые счётчики**
6
+ * (`measures` + `costByCurrency`); дериваты (`cache_hit_rate`, `output_tps`,
7
+ * итоги по валютам) считает сервис на чтении. Роллапы агрегированы: текстов
8
+ * сообщений, содержимого промптов, ключей и PII в значениях нет.
9
+ */
10
+ /** Семейства роллапов (PROP-102 §2). */
11
+ export const ANALYTICS_FAMILIES = ['usage', 'activity', 'decision', 'prompt'];
12
+ /**
13
+ * Оси измерений роллапа. Короткие ключи `dimensions`; `day` — отдельное поле
14
+ * бакета (`AnalyticsRollupBucket.day`), но участвует в фильтрах и группировке.
15
+ */
16
+ export const ANALYTICS_DIMENSIONS = ['day', 'user', 'project', 'model', 'agent', 'provider'];
17
+ /**
18
+ * Известные меры по семействам. Имена — snake_case (как в `sessions/stats.ts`:
19
+ * `input_tokens`/`output_tokens`/`cost_usd`/…). Список — подсказка/валидация
20
+ * уровня домена: хранилище неизвестные числовые меры не отбрасывает.
21
+ */
22
+ export const ANALYTICS_MEASURES_BY_FAMILY = {
23
+ usage: [
24
+ 'input_tokens',
25
+ 'output_tokens',
26
+ 'cache_read_tokens',
27
+ 'cache_write_tokens',
28
+ 'reasoning_tokens',
29
+ 'requests',
30
+ 'messages',
31
+ 'duration_ms',
32
+ ],
33
+ activity: [
34
+ 'sessions_created',
35
+ 'sessions_archived',
36
+ 'messages_user',
37
+ 'messages_assistant',
38
+ 'messages_tool',
39
+ 'tool_calls',
40
+ 'errors',
41
+ 'aborts',
42
+ 'turns',
43
+ ],
44
+ // Персистентная замена in-memory снимка `decisionMetrics` (ADR-084); модель — ось, `by_model` не дублируется.
45
+ decision: ['calls', 'handled', 'fallback', 'escalated', 'attempts', 'rejected'],
46
+ // `prompt` — производные от `usage` (`cache_hit_rate`, доля reasoning, output tps): отдельной записи не требует.
47
+ prompt: [],
48
+ };
49
+ /**
50
+ * Дериваты, которые сервис считает **на чтении** из сырых счётчиков (не
51
+ * персистятся, PROP-102 §2). В строке отчёта лежат рядом с сырыми мерами; при
52
+ * экспорте выносятся отдельными колонками после сырых мер.
53
+ */
54
+ export const ANALYTICS_DERIVED_MEASURES = [
55
+ 'total_tokens',
56
+ 'cache_hit_rate',
57
+ 'reasoning_ratio',
58
+ 'output_tps',
59
+ ];
60
+ /** Формат выгрузки отчёта (server-side, только данные — PROP-102 §6). */
61
+ export const ANALYTICS_EXPORT_FORMATS = ['csv', 'json'];
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Egress-политика исходящих запросов (web/инструкции/скиллы/webhooks/providers/MCP).
3
+ *
4
+ * Единый формат политики (`mode` + `list` + `exceptions`) используется всеми
5
+ * потребителями; `webhooks` дополнительно поддерживает `mode: 'off'` (dev, без
6
+ * проверок и без требования https). Семантика:
7
+ * - `exceptions` — allow-правила, проверяются **первыми** (точный hostname,
8
+ * `*.suffix`, CIDR/IP); hostname-правило разрешает сразу, CIDR — по резолву;
9
+ * - `deny` + `list` — блок, если хотя бы один resolved-адрес в `list`;
10
+ * - `allow` + `list` — разрешено, если ВСЕ resolved-адреса в `list` (или exception);
11
+ * - `off` (только webhooks) — проверок нет, `requireHttps = false`.
12
+ *
13
+ * Литеральные `localhost`/`*.localhost`/`*.local`/`*.internal` и приватные IP
14
+ * блокируются самой политикой (дефолтный `list`), а не отдельным зашитым списком;
15
+ * exception может их разрешить.
16
+ *
17
+ * Дефолтный `list` — **общий канонический список** `DEFAULT_MCP_PRIVATE_CIDRS`
18
+ * (`types/mcp.ts`): он же — дефолт `mcp.networkPolicy` и встроенный fallback
19
+ * `engine/net/egress-guard.ts`. Списков «заблокированных адресов» в коде больше
20
+ * нет, поэтому расширять блокировки нужно только этот список.
21
+ */
22
+ export declare const EGRESS_POLICY_MODES: readonly ["deny", "allow"];
23
+ export type EgressPolicyMode = (typeof EGRESS_POLICY_MODES)[number];
24
+ export declare const WEBHOOKS_EGRESS_POLICY_MODES: readonly ["deny", "allow", "off"];
25
+ export type WebhooksEgressPolicyMode = (typeof WEBHOOKS_EGRESS_POLICY_MODES)[number];
26
+ /** Скоупы настраиваемой egress-политики (settings/egress). */
27
+ export declare const EGRESS_POLICY_SCOPES: readonly ["tools", "webhooks"];
28
+ export type EgressPolicyScope = (typeof EGRESS_POLICY_SCOPES)[number];
29
+ /** Политика egress для встроенных инструментов (web_fetch/web_search/…). */
30
+ export interface EgressPolicy {
31
+ mode: EgressPolicyMode;
32
+ /** CIDR/IP/hostname-правила основного списка. */
33
+ list: string[];
34
+ /** Allow-правила-исключения (проверяются первыми). */
35
+ exceptions: string[];
36
+ }
37
+ /** Политика egress для исходящих webhooks (доп. режим `off` — dev). */
38
+ export interface WebhooksEgressPolicy {
39
+ mode: WebhooksEgressPolicyMode;
40
+ list: string[];
41
+ exceptions: string[];
42
+ }
43
+ /** Настройки журнала внешних запросов (аудит egress). */
44
+ export interface EgressLogConfig {
45
+ enabled: boolean;
46
+ /** Срок хранения в днях; `0` — не чистить. */
47
+ retentionDays: number;
48
+ }
49
+ /**
50
+ * Дефолтная политика встроенных инструментов: deny служебных диапазонов
51
+ * (`DEFAULT_MCP_PRIVATE_CIDRS` — общий канонический список, см. `types/mcp.ts`).
52
+ */
53
+ export declare const DEFAULT_EGRESS_TOOLS_POLICY: EgressPolicy;
54
+ /**
55
+ * Дефолтная политика webhooks: deny служебных диапазонов (тот же общий список)
56
+ * + обязательный https.
57
+ */
58
+ export declare const DEFAULT_EGRESS_WEBHOOKS_POLICY: WebhooksEgressPolicy;
59
+ /** Дефолт журнала внешних запросов: включён, хранить 7 дней. */
60
+ export declare const DEFAULT_EGRESS_LOG: EgressLogConfig;
61
+ /** Скоупы (источники) внешних запросов в журнале egress. */
62
+ export declare const EGRESS_REQUEST_SCOPES: readonly ["web_fetch", "web_search", "skills", "instructions", "webhooks", "providers", "mcp"];
63
+ export type EgressRequestScope = (typeof EGRESS_REQUEST_SCOPES)[number];
64
+ export declare const EGRESS_REQUEST_STATUSES: readonly ["allowed", "blocked", "error"];
65
+ export type EgressRequestStatus = (typeof EGRESS_REQUEST_STATUSES)[number];
66
+ /**
67
+ * ADR-099 (D1): фактический маршрут запроса — через прокси, напрямую либо
68
+ * direct-фоллбек после недоступного прокси (`proxy.fallbackDirect`).
69
+ */
70
+ export declare const EGRESS_REQUEST_VIAS: readonly ["proxy", "direct", "fallback"];
71
+ export type EgressRequestVia = (typeof EGRESS_REQUEST_VIAS)[number];
72
+ /**
73
+ * Запись журнала внешних запросов (append-only, без тел/заголовков).
74
+ * `url` хранится без query/userinfo и обрезается до 2048 символов.
75
+ */
76
+ export interface EgressRequestLogEntry {
77
+ id: string;
78
+ ts: string;
79
+ scope: EgressRequestScope;
80
+ host: string;
81
+ url: string;
82
+ method?: string;
83
+ status: EgressRequestStatus;
84
+ /** Маршрут запроса (ADR-099 D1): proxy/direct/fallback. */
85
+ via?: EgressRequestVia;
86
+ httpStatus?: number;
87
+ bytes?: number;
88
+ durationMs?: number;
89
+ reason?: string;
90
+ matchedRule?: string;
91
+ sessionId?: string;
92
+ projectId?: string;
93
+ actor?: string;
94
+ }
95
+ /** Скоупы изменений egress-политик/прокси в security-аудите. */
96
+ export declare const SECURITY_AUDIT_SCOPES: readonly ["tools", "webhooks", "mcp", "proxy", "tls"];
97
+ export type SecurityAuditScope = (typeof SECURITY_AUDIT_SCOPES)[number];
98
+ export declare const SECURITY_AUDIT_ACTIONS: readonly ["update", "reset"];
99
+ export type SecurityAuditAction = (typeof SECURITY_AUDIT_ACTIONS)[number];
100
+ /**
101
+ * Запись аудита изменений security-политик (append-only). `before`/`after` —
102
+ * снимки политики до/после операции (`null` для reset — значение не задано).
103
+ */
104
+ export interface SecurityAuditEntry {
105
+ id: string;
106
+ ts: string;
107
+ actor: string;
108
+ scope: SecurityAuditScope;
109
+ action: SecurityAuditAction;
110
+ source: 'runtime';
111
+ before: unknown;
112
+ after: unknown;
113
+ version: number;
114
+ }