@agentspec/sdk 0.4.0 → 0.5.0

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 (114) hide show
  1. package/README.md +46 -0
  2. package/dist/evidence-points-C6j4PSsQ.d.cts +1139 -0
  3. package/dist/evidence-points-C6j4PSsQ.d.ts +1139 -0
  4. package/dist/index.cjs +1727 -345
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.d.cts +1026 -2549
  7. package/dist/index.d.ts +1026 -2549
  8. package/dist/index.js +1678 -344
  9. package/dist/index.js.map +1 -1
  10. package/dist/runtime.cjs +930 -0
  11. package/dist/runtime.cjs.map +1 -0
  12. package/dist/runtime.d.cts +63 -0
  13. package/dist/runtime.d.ts +63 -0
  14. package/dist/runtime.js +921 -0
  15. package/dist/runtime.js.map +1 -0
  16. package/package.json +15 -8
  17. package/schemas/evidence/v1/contract.schema.json +2078 -0
  18. package/schemas/evidence/v1/fixtures/drifted/EvalResult.n-as-string.json +1 -0
  19. package/schemas/evidence/v1/fixtures/drifted/EvalResult.pass-rate-above-one.json +1 -0
  20. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.bad-sha.json +1 -0
  21. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.extra-field.json +1 -0
  22. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.fail-without-reason.json +1 -0
  23. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.missing-ttl.json +1 -0
  24. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.not-verifiable-without-reason.json +1 -0
  25. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-epoch.json +1 -0
  26. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-out-of-range.json +1 -0
  27. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-space-separated.json +1 -0
  28. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.sample-size-boolean.json +1 -0
  29. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.ttl-as-string.json +1 -0
  30. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.unknown-collector.json +1 -0
  31. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.unknown-source.json +1 -0
  32. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.bad-contract-version.json +1 -0
  33. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.bad-record.json +1 -0
  34. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.point-records-over-limit.json +1 -0
  35. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.with-gap.json +1 -0
  36. package/schemas/evidence/v1/fixtures/drifted/ReadinessFinding.bad-severity.json +1 -0
  37. package/schemas/evidence/v1/fixtures/drifted/SidecarPush.missing-sha.json +1 -0
  38. package/schemas/evidence/v1/fixtures/drifted/TrustPolicy.lenient.json +1 -0
  39. package/schemas/evidence/v1/fixtures/valid/EvalResult.live.json +1 -0
  40. package/schemas/evidence/v1/fixtures/valid/EvalResult.null-dataset.json +1 -0
  41. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.fail.json +1 -0
  42. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.null-collector.json +1 -0
  43. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.pass-null-reason.json +1 -0
  44. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.pass.json +1 -0
  45. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.timezone-offset.json +1 -0
  46. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.unknown-reason-code.json +1 -0
  47. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.with-collector.json +1 -0
  48. package/schemas/evidence/v1/fixtures/valid/Heartbeat.contract-null.json +1 -0
  49. package/schemas/evidence/v1/fixtures/valid/Heartbeat.contract-version.json +1 -0
  50. package/schemas/evidence/v1/fixtures/valid/Heartbeat.evidence-points.json +1 -0
  51. package/schemas/evidence/v1/fixtures/valid/Heartbeat.full.json +1 -0
  52. package/schemas/evidence/v1/fixtures/valid/Heartbeat.sdk-no-records.json +1 -0
  53. package/schemas/evidence/v1/fixtures/valid/Heartbeat.sdk.json +1 -0
  54. package/schemas/evidence/v1/fixtures/valid/ReadinessFinding.open-code.json +1 -0
  55. package/schemas/evidence/v1/fixtures/valid/ReadinessFinding.with-subject.json +1 -0
  56. package/schemas/evidence/v1/fixtures/valid/SidecarPush.declared.json +1 -0
  57. package/schemas/evidence/v1/fixtures/valid/TrustPolicy.standard.json +1 -0
  58. package/schemas/evidence/v1/fixtures/valid/TrustPolicy.strict.json +1 -0
  59. package/schemas/grader/v1/fixtures/accepts-fractional-seconds.json +62 -0
  60. package/schemas/grader/v1/fixtures/accepts-leap-day-in-year-below-100.json +62 -0
  61. package/schemas/grader/v1/fixtures/accepts-more-than-6-fractional-digits.json +62 -0
  62. package/schemas/grader/v1/fixtures/accepts-numeric-offset.json +62 -0
  63. package/schemas/grader/v1/fixtures/all-records-must-pass.json +58 -0
  64. package/schemas/grader/v1/fixtures/below-threshold-not-graded.json +61 -0
  65. package/schemas/grader/v1/fixtures/derived-rule-fails-when-a-parent-fails.json +67 -0
  66. package/schemas/grader/v1/fixtures/derived-rule-follows-memory-write-parent.json +43 -0
  67. package/schemas/grader/v1/fixtures/derived-rule-passes-with-its-parents.json +64 -0
  68. package/schemas/grader/v1/fixtures/derived-rule-unverified-when-a-parent-has-no-evidence.json +51 -0
  69. package/schemas/grader/v1/fixtures/expired-record-is-stale.json +66 -0
  70. package/schemas/grader/v1/fixtures/fail-beats-not-verifiable.json +62 -0
  71. package/schemas/grader/v1/fixtures/grade-band-b.json +62 -0
  72. package/schemas/grader/v1/fixtures/independent-from-listed-collector-is-admitted.json +39 -0
  73. package/schemas/grader/v1/fixtures/independent-from-unlisted-collector-is-rejected.json +47 -0
  74. package/schemas/grader/v1/fixtures/low-severity-coverage-only.json +90 -0
  75. package/schemas/grader/v1/fixtures/malformed-point-is-ignored.json +67 -0
  76. package/schemas/grader/v1/fixtures/never-admitted-sources-standard.json +196 -0
  77. package/schemas/grader/v1/fixtures/never-admitted-sources-strict.json +196 -0
  78. package/schemas/grader/v1/fixtures/not-admitted-outranks-mismatch.json +64 -0
  79. package/schemas/grader/v1/fixtures/not-verifiable-ignored-when-one-passes.json +58 -0
  80. package/schemas/grader/v1/fixtures/not-verifiable-only-keeps-reason.json +71 -0
  81. package/schemas/grader/v1/fixtures/not-wired-point-drops-a-fail-when-no-point-of-the-rule-is-wired.json +59 -0
  82. package/schemas/grader/v1/fixtures/not-wired-point-drops-a-wired-point-pass.json +87 -0
  83. package/schemas/grader/v1/fixtures/not-wired-point-drops-its-own-earlier-fail-when-another-point-is-wired.json +70 -0
  84. package/schemas/grader/v1/fixtures/not-wired-point-ignores-a-wired-point-fail-without-the-rule-id.json +69 -0
  85. package/schemas/grader/v1/fixtures/not-wired-point-keeps-a-wired-point-fail.json +79 -0
  86. package/schemas/grader/v1/fixtures/not-wired-point-keeps-independent-evidence.json +64 -0
  87. package/schemas/grader/v1/fixtures/not-wired-point-never-passes.json +107 -0
  88. package/schemas/grader/v1/fixtures/offline-record-is-not-admitted-yet.json +47 -0
  89. package/schemas/grader/v1/fixtures/record-without-collector-is-admitted-until-producers-set-it.json +38 -0
  90. package/schemas/grader/v1/fixtures/records-without-rule-id-never-graded.json +62 -0
  91. package/schemas/grader/v1/fixtures/rejects-compact-timestamp.json +56 -0
  92. package/schemas/grader/v1/fixtures/rejects-hour-24-lowercase-separator.json +56 -0
  93. package/schemas/grader/v1/fixtures/rejects-hour-24-space-separator.json +56 -0
  94. package/schemas/grader/v1/fixtures/rejects-hour-24.json +56 -0
  95. package/schemas/grader/v1/fixtures/rejects-impossible-date-feb-29.json +56 -0
  96. package/schemas/grader/v1/fixtures/rejects-lowercase-t.json +56 -0
  97. package/schemas/grader/v1/fixtures/rejects-lowercase-z.json +56 -0
  98. package/schemas/grader/v1/fixtures/rejects-offset-hours-above-23.json +56 -0
  99. package/schemas/grader/v1/fixtures/rejects-offset-minutes-above-59.json +56 -0
  100. package/schemas/grader/v1/fixtures/rejects-offsetless-timestamp.json +56 -0
  101. package/schemas/grader/v1/fixtures/rejects-space-separator.json +56 -0
  102. package/schemas/grader/v1/fixtures/rejects-year-zero.json +56 -0
  103. package/schemas/grader/v1/fixtures/rounds-coverage-before-the-threshold.json +850 -0
  104. package/schemas/grader/v1/fixtures/rounds-verified-before-the-band.json +674 -0
  105. package/schemas/grader/v1/fixtures/sdk-observed-from-evidence-point-rule-is-admitted-standard.json +39 -0
  106. package/schemas/grader/v1/fixtures/sdk-observed-from-evidence-point-rule-is-not-admitted-strict.json +47 -0
  107. package/schemas/grader/v1/fixtures/sdk-observed-standard.json +58 -0
  108. package/schemas/grader/v1/fixtures/sdk-observed-strict.json +66 -0
  109. package/schemas/grader/v1/fixtures/sdk-observed-without-evidence-point-source-is-rejected.json +47 -0
  110. package/schemas/grader/v1/fixtures/sdk-only-agent-all-points-fired.json +116 -0
  111. package/schemas/grader/v1/fixtures/stale-outranks-mismatch.json +64 -0
  112. package/schemas/grader/v1/fixtures/strict-admits-independent.json +39 -0
  113. package/schemas/grader/v1/fixtures/sub-millisecond-expiry-boundary.json +38 -0
  114. package/schemas/v1/agent.schema.json +372 -198
package/dist/index.d.cts CHANGED
@@ -1,124 +1,60 @@
1
1
  import { z } from 'zod';
2
+ import { T as TrustPolicy, S as SeveritySchema, E as EvidenceReason, a as EvidenceRecord } from './evidence-points-C6j4PSsQ.cjs';
3
+ import { EvidencePointAggregate, EvidencePoints } from './runtime.cjs';
4
+ export { d as EVIDENCE_SHAPES, e as EvalResult, f as EvidenceOrigin, g as EvidenceSource, h as EvidenceStatus, i as EvidenceWindow, H as Heartbeat, M as MAX_TRACE_IDS, P as PodspecFinding, R as ReadinessFinding, j as SidecarPush } from './evidence-points-C6j4PSsQ.cjs';
2
5
 
3
6
  declare const MetadataSchema: z.ZodObject<{
4
7
  name: z.ZodString;
5
8
  version: z.ZodString;
6
9
  description: z.ZodString;
7
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
10
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
8
11
  author: z.ZodOptional<z.ZodString>;
9
12
  license: z.ZodOptional<z.ZodString>;
10
- }, "strip", z.ZodTypeAny, {
11
- name: string;
12
- version: string;
13
- description: string;
14
- tags?: string[] | undefined;
15
- author?: string | undefined;
16
- license?: string | undefined;
17
- }, {
18
- name: string;
19
- version: string;
20
- description: string;
21
- tags?: string[] | undefined;
22
- author?: string | undefined;
23
- license?: string | undefined;
24
- }>;
13
+ }, z.core.$strip>;
25
14
  declare const ModelSchema: z.ZodObject<{
26
15
  provider: z.ZodString;
27
16
  id: z.ZodString;
28
17
  apiKey: z.ZodString;
18
+ baseUrl: z.ZodOptional<z.ZodString>;
29
19
  parameters: z.ZodOptional<z.ZodObject<{
30
20
  temperature: z.ZodOptional<z.ZodNumber>;
31
21
  maxTokens: z.ZodOptional<z.ZodNumber>;
32
22
  topP: z.ZodOptional<z.ZodNumber>;
33
23
  frequencyPenalty: z.ZodOptional<z.ZodNumber>;
34
24
  presencePenalty: z.ZodOptional<z.ZodNumber>;
35
- }, "strip", z.ZodTypeAny, {
36
- temperature?: number | undefined;
37
- maxTokens?: number | undefined;
38
- topP?: number | undefined;
39
- frequencyPenalty?: number | undefined;
40
- presencePenalty?: number | undefined;
41
- }, {
42
- temperature?: number | undefined;
43
- maxTokens?: number | undefined;
44
- topP?: number | undefined;
45
- frequencyPenalty?: number | undefined;
46
- presencePenalty?: number | undefined;
47
- }>>;
25
+ }, z.core.$strip>>;
48
26
  fallback: z.ZodOptional<z.ZodObject<{
49
27
  provider: z.ZodString;
50
28
  id: z.ZodString;
51
29
  apiKey: z.ZodString;
52
- triggerOn: z.ZodOptional<z.ZodArray<z.ZodEnum<["rate_limit", "timeout", "error_5xx", "error_4xx"]>, "many">>;
30
+ baseUrl: z.ZodOptional<z.ZodString>;
31
+ triggerOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
32
+ rate_limit: "rate_limit";
33
+ timeout: "timeout";
34
+ error_5xx: "error_5xx";
35
+ error_4xx: "error_4xx";
36
+ }>>>;
53
37
  maxRetries: z.ZodOptional<z.ZodNumber>;
54
- }, "strip", z.ZodTypeAny, {
55
- provider: string;
56
- id: string;
57
- apiKey: string;
58
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
59
- maxRetries?: number | undefined;
60
- }, {
61
- provider: string;
62
- id: string;
63
- apiKey: string;
64
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
65
- maxRetries?: number | undefined;
66
- }>>;
38
+ pricing: z.ZodOptional<z.ZodObject<{
39
+ input: z.ZodNumber;
40
+ output: z.ZodNumber;
41
+ cacheRead: z.ZodOptional<z.ZodNumber>;
42
+ cacheWrite: z.ZodOptional<z.ZodNumber>;
43
+ reasoning: z.ZodOptional<z.ZodNumber>;
44
+ }, z.core.$strip>>;
45
+ }, z.core.$strip>>;
46
+ pricing: z.ZodOptional<z.ZodObject<{
47
+ input: z.ZodNumber;
48
+ output: z.ZodNumber;
49
+ cacheRead: z.ZodOptional<z.ZodNumber>;
50
+ cacheWrite: z.ZodOptional<z.ZodNumber>;
51
+ reasoning: z.ZodOptional<z.ZodNumber>;
52
+ }, z.core.$strip>>;
67
53
  costControls: z.ZodOptional<z.ZodObject<{
68
54
  maxMonthlyUSD: z.ZodOptional<z.ZodNumber>;
69
55
  alertAtUSD: z.ZodOptional<z.ZodNumber>;
70
- }, "strip", z.ZodTypeAny, {
71
- maxMonthlyUSD?: number | undefined;
72
- alertAtUSD?: number | undefined;
73
- }, {
74
- maxMonthlyUSD?: number | undefined;
75
- alertAtUSD?: number | undefined;
76
- }>>;
77
- }, "strip", z.ZodTypeAny, {
78
- provider: string;
79
- id: string;
80
- apiKey: string;
81
- parameters?: {
82
- temperature?: number | undefined;
83
- maxTokens?: number | undefined;
84
- topP?: number | undefined;
85
- frequencyPenalty?: number | undefined;
86
- presencePenalty?: number | undefined;
87
- } | undefined;
88
- fallback?: {
89
- provider: string;
90
- id: string;
91
- apiKey: string;
92
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
93
- maxRetries?: number | undefined;
94
- } | undefined;
95
- costControls?: {
96
- maxMonthlyUSD?: number | undefined;
97
- alertAtUSD?: number | undefined;
98
- } | undefined;
99
- }, {
100
- provider: string;
101
- id: string;
102
- apiKey: string;
103
- parameters?: {
104
- temperature?: number | undefined;
105
- maxTokens?: number | undefined;
106
- topP?: number | undefined;
107
- frequencyPenalty?: number | undefined;
108
- presencePenalty?: number | undefined;
109
- } | undefined;
110
- fallback?: {
111
- provider: string;
112
- id: string;
113
- apiKey: string;
114
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
115
- maxRetries?: number | undefined;
116
- } | undefined;
117
- costControls?: {
118
- maxMonthlyUSD?: number | undefined;
119
- alertAtUSD?: number | undefined;
120
- } | undefined;
121
- }>;
56
+ }, z.core.$strip>>;
57
+ }, z.core.$strip>;
122
58
  declare const PromptsSchema: z.ZodObject<{
123
59
  system: z.ZodString;
124
60
  fallback: z.ZodOptional<z.ZodString>;
@@ -126,33 +62,15 @@ declare const PromptsSchema: z.ZodObject<{
126
62
  variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
127
63
  name: z.ZodString;
128
64
  value: z.ZodString;
129
- }, "strip", z.ZodTypeAny, {
130
- name: string;
131
- value: string;
132
- }, {
133
- name: string;
134
- value: string;
135
- }>, "many">>;
136
- }, "strip", z.ZodTypeAny, {
137
- system: string;
138
- hotReload: boolean;
139
- fallback?: string | undefined;
140
- variables?: {
141
- name: string;
142
- value: string;
143
- }[] | undefined;
144
- }, {
145
- system: string;
146
- fallback?: string | undefined;
147
- hotReload?: boolean | undefined;
148
- variables?: {
149
- name: string;
150
- value: string;
151
- }[] | undefined;
152
- }>;
65
+ }, z.core.$strip>>>;
66
+ }, z.core.$strip>;
153
67
  declare const ToolSchema: z.ZodObject<{
154
68
  name: z.ZodString;
155
- type: z.ZodEnum<["function", "mcp", "builtin"]>;
69
+ type: z.ZodEnum<{
70
+ function: "function";
71
+ mcp: "mcp";
72
+ builtin: "builtin";
73
+ }>;
156
74
  description: z.ZodString;
157
75
  module: z.ZodOptional<z.ZodString>;
158
76
  function: z.ZodOptional<z.ZodString>;
@@ -161,628 +79,314 @@ declare const ToolSchema: z.ZodObject<{
161
79
  destructiveHint: z.ZodOptional<z.ZodBoolean>;
162
80
  idempotentHint: z.ZodOptional<z.ZodBoolean>;
163
81
  openWorldHint: z.ZodOptional<z.ZodBoolean>;
164
- }, "strip", z.ZodTypeAny, {
165
- readOnlyHint?: boolean | undefined;
166
- destructiveHint?: boolean | undefined;
167
- idempotentHint?: boolean | undefined;
168
- openWorldHint?: boolean | undefined;
169
- }, {
170
- readOnlyHint?: boolean | undefined;
171
- destructiveHint?: boolean | undefined;
172
- idempotentHint?: boolean | undefined;
173
- openWorldHint?: boolean | undefined;
174
- }>>;
175
- }, "strip", z.ZodTypeAny, {
176
- name: string;
177
- description: string;
178
- type: "function" | "mcp" | "builtin";
179
- function?: string | undefined;
180
- module?: string | undefined;
181
- annotations?: {
182
- readOnlyHint?: boolean | undefined;
183
- destructiveHint?: boolean | undefined;
184
- idempotentHint?: boolean | undefined;
185
- openWorldHint?: boolean | undefined;
186
- } | undefined;
187
- }, {
188
- name: string;
189
- description: string;
190
- type: "function" | "mcp" | "builtin";
191
- function?: string | undefined;
192
- module?: string | undefined;
193
- annotations?: {
194
- readOnlyHint?: boolean | undefined;
195
- destructiveHint?: boolean | undefined;
196
- idempotentHint?: boolean | undefined;
197
- openWorldHint?: boolean | undefined;
198
- } | undefined;
199
- }>;
82
+ }, z.core.$strip>>;
83
+ }, z.core.$strip>;
200
84
  declare const McpServerSchema: z.ZodObject<{
201
85
  name: z.ZodString;
202
- transport: z.ZodEnum<["stdio", "sse", "http"]>;
86
+ transport: z.ZodEnum<{
87
+ stdio: "stdio";
88
+ sse: "sse";
89
+ http: "http";
90
+ }>;
203
91
  command: z.ZodOptional<z.ZodString>;
204
- args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
92
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
205
93
  url: z.ZodOptional<z.ZodString>;
206
94
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
207
95
  healthCheck: z.ZodOptional<z.ZodObject<{
208
96
  timeoutSeconds: z.ZodDefault<z.ZodNumber>;
209
- }, "strip", z.ZodTypeAny, {
210
- timeoutSeconds: number;
211
- }, {
212
- timeoutSeconds?: number | undefined;
213
- }>>;
214
- }, "strip", z.ZodTypeAny, {
215
- name: string;
216
- transport: "stdio" | "sse" | "http";
217
- command?: string | undefined;
218
- args?: string[] | undefined;
219
- url?: string | undefined;
220
- env?: Record<string, string> | undefined;
221
- healthCheck?: {
222
- timeoutSeconds: number;
223
- } | undefined;
224
- }, {
225
- name: string;
226
- transport: "stdio" | "sse" | "http";
227
- command?: string | undefined;
228
- args?: string[] | undefined;
229
- url?: string | undefined;
230
- env?: Record<string, string> | undefined;
231
- healthCheck?: {
232
- timeoutSeconds?: number | undefined;
233
- } | undefined;
234
- }>;
97
+ }, z.core.$strip>>;
98
+ }, z.core.$strip>;
235
99
  declare const MemorySchema: z.ZodObject<{
236
100
  shortTerm: z.ZodOptional<z.ZodObject<{
237
- backend: z.ZodEnum<["in-memory", "redis", "sqlite"]>;
101
+ backend: z.ZodEnum<{
102
+ "in-memory": "in-memory";
103
+ redis: "redis";
104
+ sqlite: "sqlite";
105
+ }>;
238
106
  maxTurns: z.ZodOptional<z.ZodNumber>;
239
107
  maxTokens: z.ZodOptional<z.ZodNumber>;
240
108
  ttlSeconds: z.ZodOptional<z.ZodNumber>;
241
109
  connection: z.ZodOptional<z.ZodString>;
242
- }, "strip", z.ZodTypeAny, {
243
- backend: "in-memory" | "redis" | "sqlite";
244
- maxTokens?: number | undefined;
245
- maxTurns?: number | undefined;
246
- ttlSeconds?: number | undefined;
247
- connection?: string | undefined;
248
- }, {
249
- backend: "in-memory" | "redis" | "sqlite";
250
- maxTokens?: number | undefined;
251
- maxTurns?: number | undefined;
252
- ttlSeconds?: number | undefined;
253
- connection?: string | undefined;
254
- }>>;
110
+ }, z.core.$strip>>;
255
111
  longTerm: z.ZodOptional<z.ZodObject<{
256
- backend: z.ZodEnum<["postgres", "sqlite", "mongodb"]>;
112
+ backend: z.ZodEnum<{
113
+ sqlite: "sqlite";
114
+ postgres: "postgres";
115
+ mongodb: "mongodb";
116
+ }>;
257
117
  connectionString: z.ZodString;
258
118
  table: z.ZodOptional<z.ZodString>;
259
119
  ttlDays: z.ZodOptional<z.ZodNumber>;
260
- }, "strip", z.ZodTypeAny, {
261
- backend: "sqlite" | "postgres" | "mongodb";
262
- connectionString: string;
263
- table?: string | undefined;
264
- ttlDays?: number | undefined;
265
- }, {
266
- backend: "sqlite" | "postgres" | "mongodb";
267
- connectionString: string;
268
- table?: string | undefined;
269
- ttlDays?: number | undefined;
270
- }>>;
120
+ }, z.core.$strip>>;
271
121
  vector: z.ZodOptional<z.ZodObject<{
272
- backend: z.ZodEnum<["pgvector", "pinecone", "weaviate", "qdrant", "chroma"]>;
122
+ backend: z.ZodEnum<{
123
+ pgvector: "pgvector";
124
+ pinecone: "pinecone";
125
+ weaviate: "weaviate";
126
+ qdrant: "qdrant";
127
+ chroma: "chroma";
128
+ }>;
273
129
  connectionString: z.ZodOptional<z.ZodString>;
274
130
  apiKey: z.ZodOptional<z.ZodString>;
275
131
  dimension: z.ZodNumber;
276
132
  topK: z.ZodOptional<z.ZodNumber>;
277
133
  namespace: z.ZodOptional<z.ZodString>;
278
- }, "strip", z.ZodTypeAny, {
279
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
280
- dimension: number;
281
- apiKey?: string | undefined;
282
- connectionString?: string | undefined;
283
- topK?: number | undefined;
284
- namespace?: string | undefined;
285
- }, {
286
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
287
- dimension: number;
288
- apiKey?: string | undefined;
289
- connectionString?: string | undefined;
290
- topK?: number | undefined;
291
- namespace?: string | undefined;
292
- }>>;
134
+ }, z.core.$strip>>;
293
135
  hygiene: z.ZodOptional<z.ZodObject<{
294
- piiScrubFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
136
+ piiScrubFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
295
137
  auditLog: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
296
138
  retentionPolicy: z.ZodOptional<z.ZodString>;
297
- }, "strip", z.ZodTypeAny, {
298
- auditLog: boolean;
299
- piiScrubFields?: string[] | undefined;
300
- retentionPolicy?: string | undefined;
301
- }, {
302
- piiScrubFields?: string[] | undefined;
303
- auditLog?: boolean | undefined;
304
- retentionPolicy?: string | undefined;
305
- }>>;
306
- }, "strip", z.ZodTypeAny, {
307
- shortTerm?: {
308
- backend: "in-memory" | "redis" | "sqlite";
309
- maxTokens?: number | undefined;
310
- maxTurns?: number | undefined;
311
- ttlSeconds?: number | undefined;
312
- connection?: string | undefined;
313
- } | undefined;
314
- longTerm?: {
315
- backend: "sqlite" | "postgres" | "mongodb";
316
- connectionString: string;
317
- table?: string | undefined;
318
- ttlDays?: number | undefined;
319
- } | undefined;
320
- vector?: {
321
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
322
- dimension: number;
323
- apiKey?: string | undefined;
324
- connectionString?: string | undefined;
325
- topK?: number | undefined;
326
- namespace?: string | undefined;
327
- } | undefined;
328
- hygiene?: {
329
- auditLog: boolean;
330
- piiScrubFields?: string[] | undefined;
331
- retentionPolicy?: string | undefined;
332
- } | undefined;
333
- }, {
334
- shortTerm?: {
335
- backend: "in-memory" | "redis" | "sqlite";
336
- maxTokens?: number | undefined;
337
- maxTurns?: number | undefined;
338
- ttlSeconds?: number | undefined;
339
- connection?: string | undefined;
340
- } | undefined;
341
- longTerm?: {
342
- backend: "sqlite" | "postgres" | "mongodb";
343
- connectionString: string;
344
- table?: string | undefined;
345
- ttlDays?: number | undefined;
346
- } | undefined;
347
- vector?: {
348
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
349
- dimension: number;
350
- apiKey?: string | undefined;
351
- connectionString?: string | undefined;
352
- topK?: number | undefined;
353
- namespace?: string | undefined;
354
- } | undefined;
355
- hygiene?: {
356
- piiScrubFields?: string[] | undefined;
357
- auditLog?: boolean | undefined;
358
- retentionPolicy?: string | undefined;
359
- } | undefined;
360
- }>;
139
+ }, z.core.$strip>>;
140
+ }, z.core.$strip>;
361
141
  declare const ChatEndpointSchema: z.ZodObject<{
362
142
  path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
363
- protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<["openai-compatible", "custom"]>>>;
143
+ protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
144
+ custom: "custom";
145
+ "openai-compatible": "openai-compatible";
146
+ }>>>;
364
147
  streaming: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
365
- sessionMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["stateful", "stateless"]>>>;
148
+ sessionMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
149
+ stateful: "stateful";
150
+ stateless: "stateless";
151
+ }>>>;
366
152
  threadIdHeader: z.ZodDefault<z.ZodOptional<z.ZodString>>;
367
- }, "strip", z.ZodTypeAny, {
368
- path: string;
369
- protocol: "custom" | "openai-compatible";
370
- streaming: boolean;
371
- sessionMode: "stateful" | "stateless";
372
- threadIdHeader: string;
373
- }, {
374
- path?: string | undefined;
375
- protocol?: "custom" | "openai-compatible" | undefined;
376
- streaming?: boolean | undefined;
377
- sessionMode?: "stateful" | "stateless" | undefined;
378
- threadIdHeader?: string | undefined;
379
- }>;
153
+ }, z.core.$strip>;
380
154
  declare const GuardrailsSchema: z.ZodObject<{
381
- input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
155
+ input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
382
156
  type: z.ZodLiteral<"topic-filter">;
383
- blockedTopics: z.ZodArray<z.ZodString, "many">;
384
- action: z.ZodEnum<["reject", "warn", "log"]>;
157
+ blockedTopics: z.ZodArray<z.ZodString>;
158
+ action: z.ZodEnum<{
159
+ reject: "reject";
160
+ warn: "warn";
161
+ log: "log";
162
+ }>;
385
163
  message: z.ZodOptional<z.ZodString>;
386
- }, "strip", z.ZodTypeAny, {
387
- type: "topic-filter";
388
- blockedTopics: string[];
389
- action: "reject" | "warn" | "log";
390
- message?: string | undefined;
391
- }, {
392
- type: "topic-filter";
393
- blockedTopics: string[];
394
- action: "reject" | "warn" | "log";
395
- message?: string | undefined;
396
- }>, z.ZodObject<{
164
+ }, z.core.$strip>, z.ZodObject<{
397
165
  type: z.ZodLiteral<"pii-detector">;
398
- action: z.ZodEnum<["scrub", "reject", "warn"]>;
399
- fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
400
- }, "strip", z.ZodTypeAny, {
401
- type: "pii-detector";
402
- action: "reject" | "warn" | "scrub";
403
- fields?: string[] | undefined;
404
- }, {
405
- type: "pii-detector";
406
- action: "reject" | "warn" | "scrub";
407
- fields?: string[] | undefined;
408
- }>, z.ZodObject<{
166
+ action: z.ZodEnum<{
167
+ scrub: "scrub";
168
+ reject: "reject";
169
+ warn: "warn";
170
+ }>;
171
+ fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
172
+ }, z.core.$strip>, z.ZodObject<{
409
173
  type: z.ZodLiteral<"prompt-injection">;
410
- action: z.ZodEnum<["reject", "warn"]>;
411
- sensitivity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
412
- }, "strip", z.ZodTypeAny, {
413
- type: "prompt-injection";
414
- action: "reject" | "warn";
415
- sensitivity?: "low" | "medium" | "high" | undefined;
416
- }, {
417
- type: "prompt-injection";
418
- action: "reject" | "warn";
419
- sensitivity?: "low" | "medium" | "high" | undefined;
420
- }>, z.ZodObject<{
174
+ action: z.ZodEnum<{
175
+ reject: "reject";
176
+ warn: "warn";
177
+ }>;
178
+ sensitivity: z.ZodOptional<z.ZodEnum<{
179
+ high: "high";
180
+ medium: "medium";
181
+ low: "low";
182
+ }>>;
183
+ }, z.core.$strip>, z.ZodObject<{
421
184
  type: z.ZodLiteral<"custom">;
422
185
  module: z.ZodString;
423
186
  function: z.ZodString;
424
- action: z.ZodEnum<["reject", "warn", "log"]>;
425
- }, "strip", z.ZodTypeAny, {
426
- function: string;
427
- type: "custom";
428
- module: string;
429
- action: "reject" | "warn" | "log";
430
- }, {
431
- function: string;
432
- type: "custom";
433
- module: string;
434
- action: "reject" | "warn" | "log";
435
- }>]>, "many">>;
436
- output: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
187
+ action: z.ZodEnum<{
188
+ reject: "reject";
189
+ warn: "warn";
190
+ log: "log";
191
+ }>;
192
+ }, z.core.$strip>], "type">>>;
193
+ output: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
437
194
  type: z.ZodLiteral<"hallucination-detector">;
438
195
  threshold: z.ZodNumber;
439
- action: z.ZodEnum<["reject", "retry", "warn"]>;
196
+ action: z.ZodEnum<{
197
+ reject: "reject";
198
+ warn: "warn";
199
+ retry: "retry";
200
+ }>;
440
201
  maxRetries: z.ZodOptional<z.ZodNumber>;
441
- }, "strip", z.ZodTypeAny, {
442
- type: "hallucination-detector";
443
- action: "reject" | "warn" | "retry";
444
- threshold: number;
445
- maxRetries?: number | undefined;
446
- }, {
447
- type: "hallucination-detector";
448
- action: "reject" | "warn" | "retry";
449
- threshold: number;
450
- maxRetries?: number | undefined;
451
- }>, z.ZodObject<{
202
+ }, z.core.$strip>, z.ZodObject<{
452
203
  type: z.ZodLiteral<"toxicity-filter">;
453
204
  threshold: z.ZodNumber;
454
- action: z.ZodEnum<["reject", "warn"]>;
455
- }, "strip", z.ZodTypeAny, {
456
- type: "toxicity-filter";
457
- action: "reject" | "warn";
458
- threshold: number;
459
- }, {
460
- type: "toxicity-filter";
461
- action: "reject" | "warn";
462
- threshold: number;
463
- }>, z.ZodObject<{
205
+ action: z.ZodEnum<{
206
+ reject: "reject";
207
+ warn: "warn";
208
+ }>;
209
+ }, z.core.$strip>, z.ZodObject<{
464
210
  type: z.ZodLiteral<"pii-detector">;
465
- action: z.ZodEnum<["scrub", "reject", "warn"]>;
466
- fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
467
- }, "strip", z.ZodTypeAny, {
468
- type: "pii-detector";
469
- action: "reject" | "warn" | "scrub";
470
- fields?: string[] | undefined;
471
- }, {
472
- type: "pii-detector";
473
- action: "reject" | "warn" | "scrub";
474
- fields?: string[] | undefined;
475
- }>, z.ZodObject<{
211
+ action: z.ZodEnum<{
212
+ scrub: "scrub";
213
+ reject: "reject";
214
+ warn: "warn";
215
+ }>;
216
+ fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
217
+ }, z.core.$strip>, z.ZodObject<{
476
218
  type: z.ZodLiteral<"custom">;
477
219
  module: z.ZodString;
478
220
  function: z.ZodString;
479
- action: z.ZodEnum<["reject", "warn", "log"]>;
480
- }, "strip", z.ZodTypeAny, {
481
- function: string;
482
- type: "custom";
483
- module: string;
484
- action: "reject" | "warn" | "log";
485
- }, {
486
- function: string;
487
- type: "custom";
488
- module: string;
489
- action: "reject" | "warn" | "log";
490
- }>]>, "many">>;
491
- }, "strip", z.ZodTypeAny, {
492
- input?: ({
493
- type: "topic-filter";
494
- blockedTopics: string[];
495
- action: "reject" | "warn" | "log";
496
- message?: string | undefined;
497
- } | {
498
- type: "pii-detector";
499
- action: "reject" | "warn" | "scrub";
500
- fields?: string[] | undefined;
501
- } | {
502
- type: "prompt-injection";
503
- action: "reject" | "warn";
504
- sensitivity?: "low" | "medium" | "high" | undefined;
505
- } | {
506
- function: string;
507
- type: "custom";
508
- module: string;
509
- action: "reject" | "warn" | "log";
510
- })[] | undefined;
511
- output?: ({
512
- type: "hallucination-detector";
513
- action: "reject" | "warn" | "retry";
514
- threshold: number;
515
- maxRetries?: number | undefined;
516
- } | {
517
- type: "toxicity-filter";
518
- action: "reject" | "warn";
519
- threshold: number;
520
- } | {
521
- type: "pii-detector";
522
- action: "reject" | "warn" | "scrub";
523
- fields?: string[] | undefined;
524
- } | {
525
- function: string;
526
- type: "custom";
527
- module: string;
528
- action: "reject" | "warn" | "log";
529
- })[] | undefined;
530
- }, {
531
- input?: ({
532
- type: "topic-filter";
533
- blockedTopics: string[];
534
- action: "reject" | "warn" | "log";
535
- message?: string | undefined;
536
- } | {
537
- type: "pii-detector";
538
- action: "reject" | "warn" | "scrub";
539
- fields?: string[] | undefined;
540
- } | {
541
- type: "prompt-injection";
542
- action: "reject" | "warn";
543
- sensitivity?: "low" | "medium" | "high" | undefined;
544
- } | {
545
- function: string;
546
- type: "custom";
547
- module: string;
548
- action: "reject" | "warn" | "log";
549
- })[] | undefined;
550
- output?: ({
551
- type: "hallucination-detector";
552
- action: "reject" | "warn" | "retry";
553
- threshold: number;
554
- maxRetries?: number | undefined;
555
- } | {
556
- type: "toxicity-filter";
557
- action: "reject" | "warn";
558
- threshold: number;
559
- } | {
560
- type: "pii-detector";
561
- action: "reject" | "warn" | "scrub";
562
- fields?: string[] | undefined;
563
- } | {
564
- function: string;
565
- type: "custom";
566
- module: string;
567
- action: "reject" | "warn" | "log";
568
- })[] | undefined;
569
- }>;
221
+ action: z.ZodEnum<{
222
+ reject: "reject";
223
+ warn: "warn";
224
+ log: "log";
225
+ }>;
226
+ }, z.core.$strip>], "type">>>;
227
+ }, z.core.$strip>;
570
228
  declare const EvaluationSchema: z.ZodObject<{
571
- framework: z.ZodEnum<["deepeval", "braintrust", "langsmith", "ragas", "custom"]>;
229
+ framework: z.ZodOptional<z.ZodEnum<{
230
+ custom: "custom";
231
+ deepeval: "deepeval";
232
+ braintrust: "braintrust";
233
+ langsmith: "langsmith";
234
+ ragas: "ragas";
235
+ }>>;
236
+ live: z.ZodOptional<z.ZodObject<{
237
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
238
+ custom: "custom";
239
+ faithfulness: "faithfulness";
240
+ answer_relevancy: "answer_relevancy";
241
+ hallucination: "hallucination";
242
+ toxicity: "toxicity";
243
+ context_precision: "context_precision";
244
+ bias: "bias";
245
+ grounded: "grounded";
246
+ pii_leakage: "pii_leakage";
247
+ prompt_injection: "prompt_injection";
248
+ }>>>;
249
+ thresholds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
250
+ custom: z.ZodOptional<z.ZodObject<{
251
+ name: z.ZodString;
252
+ rubric: z.ZodString;
253
+ }, z.core.$strip>>;
254
+ }, z.core.$strip>>;
255
+ custom: z.ZodOptional<z.ZodObject<{
256
+ name: z.ZodString;
257
+ rubric: z.ZodString;
258
+ }, z.core.$strip>>;
572
259
  datasets: z.ZodOptional<z.ZodArray<z.ZodObject<{
573
260
  name: z.ZodString;
574
261
  path: z.ZodString;
575
- metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["faithfulness", "answer_relevancy", "answer_similarity", "hallucination", "toxicity", "context_precision", "context_recall", "bias", "custom"]>, "many">>;
576
- }, "strip", z.ZodTypeAny, {
577
- name: string;
578
- path: string;
579
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
580
- }, {
581
- name: string;
582
- path: string;
583
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
584
- }>, "many">>;
585
- metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["faithfulness", "answer_relevancy", "answer_similarity", "hallucination", "toxicity", "context_precision", "context_recall", "bias", "custom"]>, "many">>;
262
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
263
+ custom: "custom";
264
+ faithfulness: "faithfulness";
265
+ answer_relevancy: "answer_relevancy";
266
+ answer_similarity: "answer_similarity";
267
+ hallucination: "hallucination";
268
+ toxicity: "toxicity";
269
+ context_precision: "context_precision";
270
+ context_recall: "context_recall";
271
+ bias: "bias";
272
+ grounded: "grounded";
273
+ pii_leakage: "pii_leakage";
274
+ prompt_injection: "prompt_injection";
275
+ }>>>;
276
+ }, z.core.$strip>>>;
277
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
278
+ custom: "custom";
279
+ faithfulness: "faithfulness";
280
+ answer_relevancy: "answer_relevancy";
281
+ answer_similarity: "answer_similarity";
282
+ hallucination: "hallucination";
283
+ toxicity: "toxicity";
284
+ context_precision: "context_precision";
285
+ context_recall: "context_recall";
286
+ bias: "bias";
287
+ grounded: "grounded";
288
+ pii_leakage: "pii_leakage";
289
+ prompt_injection: "prompt_injection";
290
+ }>>>;
586
291
  thresholds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
587
292
  ciGate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
588
- }, "strip", z.ZodTypeAny, {
589
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
590
- ciGate: boolean;
591
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
592
- datasets?: {
593
- name: string;
594
- path: string;
595
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
596
- }[] | undefined;
597
- thresholds?: Record<string, number> | undefined;
598
- }, {
599
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
600
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
601
- datasets?: {
602
- name: string;
603
- path: string;
604
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
605
- }[] | undefined;
606
- thresholds?: Record<string, number> | undefined;
607
- ciGate?: boolean | undefined;
608
- }>;
293
+ }, z.core.$strip>;
609
294
  declare const ObservabilitySchema: z.ZodObject<{
610
295
  tracing: z.ZodOptional<z.ZodObject<{
611
- backend: z.ZodEnum<["langfuse", "langsmith", "agentops", "otel", "honeycomb", "datadog"]>;
296
+ backend: z.ZodEnum<{
297
+ langsmith: "langsmith";
298
+ langfuse: "langfuse";
299
+ agentops: "agentops";
300
+ otel: "otel";
301
+ honeycomb: "honeycomb";
302
+ datadog: "datadog";
303
+ }>;
612
304
  endpoint: z.ZodOptional<z.ZodString>;
613
305
  publicKey: z.ZodOptional<z.ZodString>;
614
306
  secretKey: z.ZodOptional<z.ZodString>;
615
307
  sampleRate: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
616
- }, "strip", z.ZodTypeAny, {
617
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
618
- sampleRate: number;
619
- endpoint?: string | undefined;
620
- publicKey?: string | undefined;
621
- secretKey?: string | undefined;
622
- }, {
623
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
624
- endpoint?: string | undefined;
625
- publicKey?: string | undefined;
626
- secretKey?: string | undefined;
627
- sampleRate?: number | undefined;
628
- }>>;
308
+ }, z.core.$strip>>;
629
309
  metrics: z.ZodOptional<z.ZodObject<{
630
- backend: z.ZodEnum<["opentelemetry", "prometheus", "datadog"]>;
310
+ backend: z.ZodEnum<{
311
+ datadog: "datadog";
312
+ opentelemetry: "opentelemetry";
313
+ prometheus: "prometheus";
314
+ }>;
631
315
  endpoint: z.ZodOptional<z.ZodString>;
632
316
  serviceName: z.ZodOptional<z.ZodString>;
633
- }, "strip", z.ZodTypeAny, {
634
- backend: "datadog" | "opentelemetry" | "prometheus";
635
- endpoint?: string | undefined;
636
- serviceName?: string | undefined;
637
- }, {
638
- backend: "datadog" | "opentelemetry" | "prometheus";
639
- endpoint?: string | undefined;
640
- serviceName?: string | undefined;
641
- }>>;
317
+ }, z.core.$strip>>;
642
318
  logging: z.ZodOptional<z.ZodObject<{
643
- level: z.ZodDefault<z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>>;
319
+ level: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
320
+ info: "info";
321
+ error: "error";
322
+ warn: "warn";
323
+ debug: "debug";
324
+ }>>>;
644
325
  structured: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
645
- redactFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
646
- }, "strip", z.ZodTypeAny, {
647
- level: "warn" | "debug" | "info" | "error";
648
- structured: boolean;
649
- redactFields?: string[] | undefined;
650
- }, {
651
- level?: "warn" | "debug" | "info" | "error" | undefined;
652
- structured?: boolean | undefined;
653
- redactFields?: string[] | undefined;
654
- }>>;
655
- }, "strip", z.ZodTypeAny, {
656
- metrics?: {
657
- backend: "datadog" | "opentelemetry" | "prometheus";
658
- endpoint?: string | undefined;
659
- serviceName?: string | undefined;
660
- } | undefined;
661
- tracing?: {
662
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
663
- sampleRate: number;
664
- endpoint?: string | undefined;
665
- publicKey?: string | undefined;
666
- secretKey?: string | undefined;
667
- } | undefined;
668
- logging?: {
669
- level: "warn" | "debug" | "info" | "error";
670
- structured: boolean;
671
- redactFields?: string[] | undefined;
672
- } | undefined;
673
- }, {
674
- metrics?: {
675
- backend: "datadog" | "opentelemetry" | "prometheus";
676
- endpoint?: string | undefined;
677
- serviceName?: string | undefined;
678
- } | undefined;
679
- tracing?: {
680
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
681
- endpoint?: string | undefined;
682
- publicKey?: string | undefined;
683
- secretKey?: string | undefined;
684
- sampleRate?: number | undefined;
685
- } | undefined;
686
- logging?: {
687
- level?: "warn" | "debug" | "info" | "error" | undefined;
688
- structured?: boolean | undefined;
689
- redactFields?: string[] | undefined;
690
- } | undefined;
691
- }>;
326
+ redactFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
327
+ }, z.core.$strip>>;
328
+ }, z.core.$strip>;
692
329
  declare const ComplianceSchema: z.ZodObject<{
693
- packs: z.ZodOptional<z.ZodArray<z.ZodEnum<["owasp-llm-top10", "memory-hygiene", "model-resilience", "evaluation-coverage", "observability", "metadata-quality"]>, "many">>;
330
+ packs: z.ZodOptional<z.ZodArray<z.ZodEnum<{
331
+ observability: "observability";
332
+ "owasp-llm-top10": "owasp-llm-top10";
333
+ "memory-hygiene": "memory-hygiene";
334
+ "model-resilience": "model-resilience";
335
+ "evaluation-coverage": "evaluation-coverage";
336
+ "metadata-quality": "metadata-quality";
337
+ }>>>;
694
338
  suppressions: z.ZodOptional<z.ZodArray<z.ZodObject<{
695
339
  rule: z.ZodString;
696
340
  reason: z.ZodString;
697
341
  approvedBy: z.ZodOptional<z.ZodString>;
698
342
  expires: z.ZodOptional<z.ZodString>;
699
- }, "strip", z.ZodTypeAny, {
700
- rule: string;
701
- reason: string;
702
- approvedBy?: string | undefined;
703
- expires?: string | undefined;
704
- }, {
705
- rule: string;
706
- reason: string;
707
- approvedBy?: string | undefined;
708
- expires?: string | undefined;
709
- }>, "many">>;
710
- auditSchedule: z.ZodOptional<z.ZodEnum<["daily", "weekly", "monthly", "on-change"]>>;
711
- }, "strip", z.ZodTypeAny, {
712
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
713
- suppressions?: {
714
- rule: string;
715
- reason: string;
716
- approvedBy?: string | undefined;
717
- expires?: string | undefined;
718
- }[] | undefined;
719
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
720
- }, {
721
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
722
- suppressions?: {
723
- rule: string;
724
- reason: string;
725
- approvedBy?: string | undefined;
726
- expires?: string | undefined;
727
- }[] | undefined;
728
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
729
- }>;
343
+ }, z.core.$strip>>>;
344
+ auditSchedule: z.ZodOptional<z.ZodEnum<{
345
+ daily: "daily";
346
+ weekly: "weekly";
347
+ monthly: "monthly";
348
+ "on-change": "on-change";
349
+ }>>;
350
+ }, z.core.$strip>;
730
351
  declare const RequiresSchema: z.ZodObject<{
731
- envVars: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
352
+ envVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
732
353
  services: z.ZodOptional<z.ZodArray<z.ZodObject<{
733
- type: z.ZodEnum<["postgres", "redis", "mysql", "mongodb", "elasticsearch"]>;
354
+ type: z.ZodEnum<{
355
+ redis: "redis";
356
+ postgres: "postgres";
357
+ mongodb: "mongodb";
358
+ mysql: "mysql";
359
+ elasticsearch: "elasticsearch";
360
+ }>;
734
361
  connection: z.ZodString;
735
- }, "strip", z.ZodTypeAny, {
736
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
737
- connection: string;
738
- }, {
739
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
740
- connection: string;
741
- }>, "many">>;
362
+ }, z.core.$strip>>>;
742
363
  minimumMemoryMB: z.ZodOptional<z.ZodNumber>;
743
364
  nodeVersion: z.ZodOptional<z.ZodString>;
744
365
  pythonVersion: z.ZodOptional<z.ZodString>;
745
- }, "strip", z.ZodTypeAny, {
746
- envVars?: string[] | undefined;
747
- services?: {
748
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
749
- connection: string;
750
- }[] | undefined;
751
- minimumMemoryMB?: number | undefined;
752
- nodeVersion?: string | undefined;
753
- pythonVersion?: string | undefined;
754
- }, {
755
- envVars?: string[] | undefined;
756
- services?: {
757
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
758
- connection: string;
759
- }[] | undefined;
760
- minimumMemoryMB?: number | undefined;
761
- nodeVersion?: string | undefined;
762
- pythonVersion?: string | undefined;
763
- }>;
366
+ }, z.core.$strip>;
764
367
  declare const HumanInTheLoopSchema: z.ZodObject<{
765
368
  enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
766
- approvalRequired: z.ZodOptional<z.ZodArray<z.ZodEnum<["before-destructive-tool", "before-external-call", "on-low-confidence", "on-high-cost", "always"]>, "many">>;
369
+ approvalRequired: z.ZodOptional<z.ZodArray<z.ZodEnum<{
370
+ "before-destructive-tool": "before-destructive-tool";
371
+ "before-external-call": "before-external-call";
372
+ "on-low-confidence": "on-low-confidence";
373
+ "on-high-cost": "on-high-cost";
374
+ always: "always";
375
+ }>>>;
767
376
  timeoutSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
768
- timeoutAction: z.ZodDefault<z.ZodOptional<z.ZodEnum<["reject", "proceed", "escalate"]>>>;
769
- notifyVia: z.ZodOptional<z.ZodArray<z.ZodEnum<["slack", "email", "webhook", "console"]>, "many">>;
377
+ timeoutAction: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
378
+ reject: "reject";
379
+ proceed: "proceed";
380
+ escalate: "escalate";
381
+ }>>>;
382
+ notifyVia: z.ZodOptional<z.ZodArray<z.ZodEnum<{
383
+ webhook: "webhook";
384
+ slack: "slack";
385
+ email: "email";
386
+ console: "console";
387
+ }>>>;
770
388
  webhookUrl: z.ZodOptional<z.ZodString>;
771
- }, "strip", z.ZodTypeAny, {
772
- timeoutSeconds: number;
773
- enabled: boolean;
774
- timeoutAction: "reject" | "proceed" | "escalate";
775
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
776
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
777
- webhookUrl?: string | undefined;
778
- }, {
779
- timeoutSeconds?: number | undefined;
780
- enabled?: boolean | undefined;
781
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
782
- timeoutAction?: "reject" | "proceed" | "escalate" | undefined;
783
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
784
- webhookUrl?: string | undefined;
785
- }>;
389
+ }, z.core.$strip>;
786
390
  declare const ManifestSchema: z.ZodObject<{
787
391
  apiVersion: z.ZodLiteral<"agentspec.io/v1">;
788
392
  kind: z.ZodLiteral<"AgentSpec">;
@@ -790,122 +394,55 @@ declare const ManifestSchema: z.ZodObject<{
790
394
  name: z.ZodString;
791
395
  version: z.ZodString;
792
396
  description: z.ZodString;
793
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
397
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
794
398
  author: z.ZodOptional<z.ZodString>;
795
399
  license: z.ZodOptional<z.ZodString>;
796
- }, "strip", z.ZodTypeAny, {
797
- name: string;
798
- version: string;
799
- description: string;
800
- tags?: string[] | undefined;
801
- author?: string | undefined;
802
- license?: string | undefined;
803
- }, {
804
- name: string;
805
- version: string;
806
- description: string;
807
- tags?: string[] | undefined;
808
- author?: string | undefined;
809
- license?: string | undefined;
810
- }>;
400
+ }, z.core.$strip>;
811
401
  spec: z.ZodObject<{
812
402
  model: z.ZodObject<{
813
403
  provider: z.ZodString;
814
404
  id: z.ZodString;
815
405
  apiKey: z.ZodString;
406
+ baseUrl: z.ZodOptional<z.ZodString>;
816
407
  parameters: z.ZodOptional<z.ZodObject<{
817
408
  temperature: z.ZodOptional<z.ZodNumber>;
818
409
  maxTokens: z.ZodOptional<z.ZodNumber>;
819
410
  topP: z.ZodOptional<z.ZodNumber>;
820
411
  frequencyPenalty: z.ZodOptional<z.ZodNumber>;
821
412
  presencePenalty: z.ZodOptional<z.ZodNumber>;
822
- }, "strip", z.ZodTypeAny, {
823
- temperature?: number | undefined;
824
- maxTokens?: number | undefined;
825
- topP?: number | undefined;
826
- frequencyPenalty?: number | undefined;
827
- presencePenalty?: number | undefined;
828
- }, {
829
- temperature?: number | undefined;
830
- maxTokens?: number | undefined;
831
- topP?: number | undefined;
832
- frequencyPenalty?: number | undefined;
833
- presencePenalty?: number | undefined;
834
- }>>;
413
+ }, z.core.$strip>>;
835
414
  fallback: z.ZodOptional<z.ZodObject<{
836
415
  provider: z.ZodString;
837
416
  id: z.ZodString;
838
417
  apiKey: z.ZodString;
839
- triggerOn: z.ZodOptional<z.ZodArray<z.ZodEnum<["rate_limit", "timeout", "error_5xx", "error_4xx"]>, "many">>;
418
+ baseUrl: z.ZodOptional<z.ZodString>;
419
+ triggerOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
420
+ rate_limit: "rate_limit";
421
+ timeout: "timeout";
422
+ error_5xx: "error_5xx";
423
+ error_4xx: "error_4xx";
424
+ }>>>;
840
425
  maxRetries: z.ZodOptional<z.ZodNumber>;
841
- }, "strip", z.ZodTypeAny, {
842
- provider: string;
843
- id: string;
844
- apiKey: string;
845
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
846
- maxRetries?: number | undefined;
847
- }, {
848
- provider: string;
849
- id: string;
850
- apiKey: string;
851
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
852
- maxRetries?: number | undefined;
853
- }>>;
426
+ pricing: z.ZodOptional<z.ZodObject<{
427
+ input: z.ZodNumber;
428
+ output: z.ZodNumber;
429
+ cacheRead: z.ZodOptional<z.ZodNumber>;
430
+ cacheWrite: z.ZodOptional<z.ZodNumber>;
431
+ reasoning: z.ZodOptional<z.ZodNumber>;
432
+ }, z.core.$strip>>;
433
+ }, z.core.$strip>>;
434
+ pricing: z.ZodOptional<z.ZodObject<{
435
+ input: z.ZodNumber;
436
+ output: z.ZodNumber;
437
+ cacheRead: z.ZodOptional<z.ZodNumber>;
438
+ cacheWrite: z.ZodOptional<z.ZodNumber>;
439
+ reasoning: z.ZodOptional<z.ZodNumber>;
440
+ }, z.core.$strip>>;
854
441
  costControls: z.ZodOptional<z.ZodObject<{
855
442
  maxMonthlyUSD: z.ZodOptional<z.ZodNumber>;
856
443
  alertAtUSD: z.ZodOptional<z.ZodNumber>;
857
- }, "strip", z.ZodTypeAny, {
858
- maxMonthlyUSD?: number | undefined;
859
- alertAtUSD?: number | undefined;
860
- }, {
861
- maxMonthlyUSD?: number | undefined;
862
- alertAtUSD?: number | undefined;
863
- }>>;
864
- }, "strip", z.ZodTypeAny, {
865
- provider: string;
866
- id: string;
867
- apiKey: string;
868
- parameters?: {
869
- temperature?: number | undefined;
870
- maxTokens?: number | undefined;
871
- topP?: number | undefined;
872
- frequencyPenalty?: number | undefined;
873
- presencePenalty?: number | undefined;
874
- } | undefined;
875
- fallback?: {
876
- provider: string;
877
- id: string;
878
- apiKey: string;
879
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
880
- maxRetries?: number | undefined;
881
- } | undefined;
882
- costControls?: {
883
- maxMonthlyUSD?: number | undefined;
884
- alertAtUSD?: number | undefined;
885
- } | undefined;
886
- }, {
887
- provider: string;
888
- id: string;
889
- apiKey: string;
890
- parameters?: {
891
- temperature?: number | undefined;
892
- maxTokens?: number | undefined;
893
- topP?: number | undefined;
894
- frequencyPenalty?: number | undefined;
895
- presencePenalty?: number | undefined;
896
- } | undefined;
897
- fallback?: {
898
- provider: string;
899
- id: string;
900
- apiKey: string;
901
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
902
- maxRetries?: number | undefined;
903
- } | undefined;
904
- costControls?: {
905
- maxMonthlyUSD?: number | undefined;
906
- alertAtUSD?: number | undefined;
907
- } | undefined;
908
- }>;
444
+ }, z.core.$strip>>;
445
+ }, z.core.$strip>;
909
446
  prompts: z.ZodObject<{
910
447
  system: z.ZodString;
911
448
  fallback: z.ZodOptional<z.ZodString>;
@@ -913,33 +450,15 @@ declare const ManifestSchema: z.ZodObject<{
913
450
  variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
914
451
  name: z.ZodString;
915
452
  value: z.ZodString;
916
- }, "strip", z.ZodTypeAny, {
917
- name: string;
918
- value: string;
919
- }, {
920
- name: string;
921
- value: string;
922
- }>, "many">>;
923
- }, "strip", z.ZodTypeAny, {
924
- system: string;
925
- hotReload: boolean;
926
- fallback?: string | undefined;
927
- variables?: {
928
- name: string;
929
- value: string;
930
- }[] | undefined;
931
- }, {
932
- system: string;
933
- fallback?: string | undefined;
934
- hotReload?: boolean | undefined;
935
- variables?: {
936
- name: string;
937
- value: string;
938
- }[] | undefined;
939
- }>;
453
+ }, z.core.$strip>>>;
454
+ }, z.core.$strip>;
940
455
  tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
941
456
  name: z.ZodString;
942
- type: z.ZodEnum<["function", "mcp", "builtin"]>;
457
+ type: z.ZodEnum<{
458
+ function: "function";
459
+ mcp: "mcp";
460
+ builtin: "builtin";
461
+ }>;
943
462
  description: z.ZodString;
944
463
  module: z.ZodOptional<z.ZodString>;
945
464
  function: z.ZodOptional<z.ZodString>;
@@ -948,1795 +467,378 @@ declare const ManifestSchema: z.ZodObject<{
948
467
  destructiveHint: z.ZodOptional<z.ZodBoolean>;
949
468
  idempotentHint: z.ZodOptional<z.ZodBoolean>;
950
469
  openWorldHint: z.ZodOptional<z.ZodBoolean>;
951
- }, "strip", z.ZodTypeAny, {
952
- readOnlyHint?: boolean | undefined;
953
- destructiveHint?: boolean | undefined;
954
- idempotentHint?: boolean | undefined;
955
- openWorldHint?: boolean | undefined;
956
- }, {
957
- readOnlyHint?: boolean | undefined;
958
- destructiveHint?: boolean | undefined;
959
- idempotentHint?: boolean | undefined;
960
- openWorldHint?: boolean | undefined;
961
- }>>;
962
- }, "strip", z.ZodTypeAny, {
963
- name: string;
964
- description: string;
965
- type: "function" | "mcp" | "builtin";
966
- function?: string | undefined;
967
- module?: string | undefined;
968
- annotations?: {
969
- readOnlyHint?: boolean | undefined;
970
- destructiveHint?: boolean | undefined;
971
- idempotentHint?: boolean | undefined;
972
- openWorldHint?: boolean | undefined;
973
- } | undefined;
974
- }, {
975
- name: string;
976
- description: string;
977
- type: "function" | "mcp" | "builtin";
978
- function?: string | undefined;
979
- module?: string | undefined;
980
- annotations?: {
981
- readOnlyHint?: boolean | undefined;
982
- destructiveHint?: boolean | undefined;
983
- idempotentHint?: boolean | undefined;
984
- openWorldHint?: boolean | undefined;
985
- } | undefined;
986
- }>, "many">>;
470
+ }, z.core.$strip>>;
471
+ }, z.core.$strip>>>;
987
472
  mcp: z.ZodOptional<z.ZodObject<{
988
473
  servers: z.ZodArray<z.ZodObject<{
989
474
  name: z.ZodString;
990
- transport: z.ZodEnum<["stdio", "sse", "http"]>;
475
+ transport: z.ZodEnum<{
476
+ stdio: "stdio";
477
+ sse: "sse";
478
+ http: "http";
479
+ }>;
991
480
  command: z.ZodOptional<z.ZodString>;
992
- args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
481
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
993
482
  url: z.ZodOptional<z.ZodString>;
994
483
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
995
484
  healthCheck: z.ZodOptional<z.ZodObject<{
996
485
  timeoutSeconds: z.ZodDefault<z.ZodNumber>;
997
- }, "strip", z.ZodTypeAny, {
998
- timeoutSeconds: number;
999
- }, {
1000
- timeoutSeconds?: number | undefined;
1001
- }>>;
1002
- }, "strip", z.ZodTypeAny, {
1003
- name: string;
1004
- transport: "stdio" | "sse" | "http";
1005
- command?: string | undefined;
1006
- args?: string[] | undefined;
1007
- url?: string | undefined;
1008
- env?: Record<string, string> | undefined;
1009
- healthCheck?: {
1010
- timeoutSeconds: number;
1011
- } | undefined;
1012
- }, {
1013
- name: string;
1014
- transport: "stdio" | "sse" | "http";
1015
- command?: string | undefined;
1016
- args?: string[] | undefined;
1017
- url?: string | undefined;
1018
- env?: Record<string, string> | undefined;
1019
- healthCheck?: {
1020
- timeoutSeconds?: number | undefined;
1021
- } | undefined;
1022
- }>, "many">;
1023
- }, "strip", z.ZodTypeAny, {
1024
- servers: {
1025
- name: string;
1026
- transport: "stdio" | "sse" | "http";
1027
- command?: string | undefined;
1028
- args?: string[] | undefined;
1029
- url?: string | undefined;
1030
- env?: Record<string, string> | undefined;
1031
- healthCheck?: {
1032
- timeoutSeconds: number;
1033
- } | undefined;
1034
- }[];
1035
- }, {
1036
- servers: {
1037
- name: string;
1038
- transport: "stdio" | "sse" | "http";
1039
- command?: string | undefined;
1040
- args?: string[] | undefined;
1041
- url?: string | undefined;
1042
- env?: Record<string, string> | undefined;
1043
- healthCheck?: {
1044
- timeoutSeconds?: number | undefined;
1045
- } | undefined;
1046
- }[];
1047
- }>>;
486
+ }, z.core.$strip>>;
487
+ }, z.core.$strip>>;
488
+ }, z.core.$strip>>;
1048
489
  memory: z.ZodOptional<z.ZodObject<{
1049
490
  shortTerm: z.ZodOptional<z.ZodObject<{
1050
- backend: z.ZodEnum<["in-memory", "redis", "sqlite"]>;
491
+ backend: z.ZodEnum<{
492
+ "in-memory": "in-memory";
493
+ redis: "redis";
494
+ sqlite: "sqlite";
495
+ }>;
1051
496
  maxTurns: z.ZodOptional<z.ZodNumber>;
1052
497
  maxTokens: z.ZodOptional<z.ZodNumber>;
1053
498
  ttlSeconds: z.ZodOptional<z.ZodNumber>;
1054
499
  connection: z.ZodOptional<z.ZodString>;
1055
- }, "strip", z.ZodTypeAny, {
1056
- backend: "in-memory" | "redis" | "sqlite";
1057
- maxTokens?: number | undefined;
1058
- maxTurns?: number | undefined;
1059
- ttlSeconds?: number | undefined;
1060
- connection?: string | undefined;
1061
- }, {
1062
- backend: "in-memory" | "redis" | "sqlite";
1063
- maxTokens?: number | undefined;
1064
- maxTurns?: number | undefined;
1065
- ttlSeconds?: number | undefined;
1066
- connection?: string | undefined;
1067
- }>>;
500
+ }, z.core.$strip>>;
1068
501
  longTerm: z.ZodOptional<z.ZodObject<{
1069
- backend: z.ZodEnum<["postgres", "sqlite", "mongodb"]>;
502
+ backend: z.ZodEnum<{
503
+ sqlite: "sqlite";
504
+ postgres: "postgres";
505
+ mongodb: "mongodb";
506
+ }>;
1070
507
  connectionString: z.ZodString;
1071
508
  table: z.ZodOptional<z.ZodString>;
1072
509
  ttlDays: z.ZodOptional<z.ZodNumber>;
1073
- }, "strip", z.ZodTypeAny, {
1074
- backend: "sqlite" | "postgres" | "mongodb";
1075
- connectionString: string;
1076
- table?: string | undefined;
1077
- ttlDays?: number | undefined;
1078
- }, {
1079
- backend: "sqlite" | "postgres" | "mongodb";
1080
- connectionString: string;
1081
- table?: string | undefined;
1082
- ttlDays?: number | undefined;
1083
- }>>;
510
+ }, z.core.$strip>>;
1084
511
  vector: z.ZodOptional<z.ZodObject<{
1085
- backend: z.ZodEnum<["pgvector", "pinecone", "weaviate", "qdrant", "chroma"]>;
512
+ backend: z.ZodEnum<{
513
+ pgvector: "pgvector";
514
+ pinecone: "pinecone";
515
+ weaviate: "weaviate";
516
+ qdrant: "qdrant";
517
+ chroma: "chroma";
518
+ }>;
1086
519
  connectionString: z.ZodOptional<z.ZodString>;
1087
520
  apiKey: z.ZodOptional<z.ZodString>;
1088
521
  dimension: z.ZodNumber;
1089
522
  topK: z.ZodOptional<z.ZodNumber>;
1090
523
  namespace: z.ZodOptional<z.ZodString>;
1091
- }, "strip", z.ZodTypeAny, {
1092
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
1093
- dimension: number;
1094
- apiKey?: string | undefined;
1095
- connectionString?: string | undefined;
1096
- topK?: number | undefined;
1097
- namespace?: string | undefined;
1098
- }, {
1099
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
1100
- dimension: number;
1101
- apiKey?: string | undefined;
1102
- connectionString?: string | undefined;
1103
- topK?: number | undefined;
1104
- namespace?: string | undefined;
1105
- }>>;
524
+ }, z.core.$strip>>;
1106
525
  hygiene: z.ZodOptional<z.ZodObject<{
1107
- piiScrubFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
526
+ piiScrubFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
1108
527
  auditLog: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1109
528
  retentionPolicy: z.ZodOptional<z.ZodString>;
1110
- }, "strip", z.ZodTypeAny, {
1111
- auditLog: boolean;
1112
- piiScrubFields?: string[] | undefined;
1113
- retentionPolicy?: string | undefined;
1114
- }, {
1115
- piiScrubFields?: string[] | undefined;
1116
- auditLog?: boolean | undefined;
1117
- retentionPolicy?: string | undefined;
1118
- }>>;
1119
- }, "strip", z.ZodTypeAny, {
1120
- shortTerm?: {
1121
- backend: "in-memory" | "redis" | "sqlite";
1122
- maxTokens?: number | undefined;
1123
- maxTurns?: number | undefined;
1124
- ttlSeconds?: number | undefined;
1125
- connection?: string | undefined;
1126
- } | undefined;
1127
- longTerm?: {
1128
- backend: "sqlite" | "postgres" | "mongodb";
1129
- connectionString: string;
1130
- table?: string | undefined;
1131
- ttlDays?: number | undefined;
1132
- } | undefined;
1133
- vector?: {
1134
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
1135
- dimension: number;
1136
- apiKey?: string | undefined;
1137
- connectionString?: string | undefined;
1138
- topK?: number | undefined;
1139
- namespace?: string | undefined;
1140
- } | undefined;
1141
- hygiene?: {
1142
- auditLog: boolean;
1143
- piiScrubFields?: string[] | undefined;
1144
- retentionPolicy?: string | undefined;
1145
- } | undefined;
1146
- }, {
1147
- shortTerm?: {
1148
- backend: "in-memory" | "redis" | "sqlite";
1149
- maxTokens?: number | undefined;
1150
- maxTurns?: number | undefined;
1151
- ttlSeconds?: number | undefined;
1152
- connection?: string | undefined;
1153
- } | undefined;
1154
- longTerm?: {
1155
- backend: "sqlite" | "postgres" | "mongodb";
1156
- connectionString: string;
1157
- table?: string | undefined;
1158
- ttlDays?: number | undefined;
1159
- } | undefined;
1160
- vector?: {
1161
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
1162
- dimension: number;
1163
- apiKey?: string | undefined;
1164
- connectionString?: string | undefined;
1165
- topK?: number | undefined;
1166
- namespace?: string | undefined;
1167
- } | undefined;
1168
- hygiene?: {
1169
- piiScrubFields?: string[] | undefined;
1170
- auditLog?: boolean | undefined;
1171
- retentionPolicy?: string | undefined;
1172
- } | undefined;
1173
- }>>;
529
+ }, z.core.$strip>>;
530
+ }, z.core.$strip>>;
1174
531
  subagents: z.ZodOptional<z.ZodArray<z.ZodObject<{
1175
532
  name: z.ZodString;
1176
- ref: z.ZodUnion<[z.ZodObject<{
533
+ ref: z.ZodUnion<readonly [z.ZodObject<{
1177
534
  agentspec: z.ZodString;
1178
- }, "strip", z.ZodTypeAny, {
1179
- agentspec: string;
1180
- }, {
1181
- agentspec: string;
1182
- }>, z.ZodObject<{
535
+ }, z.core.$strip>, z.ZodObject<{
1183
536
  a2a: z.ZodObject<{
1184
537
  url: z.ZodString;
1185
538
  auth: z.ZodOptional<z.ZodObject<{
1186
- type: z.ZodEnum<["bearer", "apikey", "none"]>;
539
+ type: z.ZodEnum<{
540
+ none: "none";
541
+ bearer: "bearer";
542
+ apikey: "apikey";
543
+ }>;
1187
544
  token: z.ZodOptional<z.ZodString>;
1188
545
  header: z.ZodOptional<z.ZodString>;
1189
- }, "strip", z.ZodTypeAny, {
1190
- type: "bearer" | "apikey" | "none";
1191
- token?: string | undefined;
1192
- header?: string | undefined;
1193
- }, {
1194
- type: "bearer" | "apikey" | "none";
1195
- token?: string | undefined;
1196
- header?: string | undefined;
1197
- }>>;
1198
- }, "strip", z.ZodTypeAny, {
1199
- url: string;
1200
- auth?: {
1201
- type: "bearer" | "apikey" | "none";
1202
- token?: string | undefined;
1203
- header?: string | undefined;
1204
- } | undefined;
1205
- }, {
1206
- url: string;
1207
- auth?: {
1208
- type: "bearer" | "apikey" | "none";
1209
- token?: string | undefined;
1210
- header?: string | undefined;
1211
- } | undefined;
1212
- }>;
1213
- }, "strip", z.ZodTypeAny, {
1214
- a2a: {
1215
- url: string;
1216
- auth?: {
1217
- type: "bearer" | "apikey" | "none";
1218
- token?: string | undefined;
1219
- header?: string | undefined;
1220
- } | undefined;
1221
- };
1222
- }, {
1223
- a2a: {
1224
- url: string;
1225
- auth?: {
1226
- type: "bearer" | "apikey" | "none";
1227
- token?: string | undefined;
1228
- header?: string | undefined;
1229
- } | undefined;
1230
- };
1231
- }>]>;
1232
- invocation: z.ZodEnum<["parallel", "sequential", "on-demand"]>;
546
+ }, z.core.$strip>>;
547
+ }, z.core.$strip>;
548
+ }, z.core.$strip>]>;
549
+ invocation: z.ZodEnum<{
550
+ parallel: "parallel";
551
+ sequential: "sequential";
552
+ "on-demand": "on-demand";
553
+ }>;
1233
554
  passContext: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1234
- triggerKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1235
- }, "strip", z.ZodTypeAny, {
1236
- name: string;
1237
- ref: {
1238
- agentspec: string;
1239
- } | {
1240
- a2a: {
1241
- url: string;
1242
- auth?: {
1243
- type: "bearer" | "apikey" | "none";
1244
- token?: string | undefined;
1245
- header?: string | undefined;
1246
- } | undefined;
1247
- };
1248
- };
1249
- invocation: "parallel" | "sequential" | "on-demand";
1250
- passContext: boolean;
1251
- triggerKeywords?: string[] | undefined;
1252
- }, {
1253
- name: string;
1254
- ref: {
1255
- agentspec: string;
1256
- } | {
1257
- a2a: {
1258
- url: string;
1259
- auth?: {
1260
- type: "bearer" | "apikey" | "none";
1261
- token?: string | undefined;
1262
- header?: string | undefined;
1263
- } | undefined;
1264
- };
1265
- };
1266
- invocation: "parallel" | "sequential" | "on-demand";
1267
- passContext?: boolean | undefined;
1268
- triggerKeywords?: string[] | undefined;
1269
- }>, "many">>;
555
+ triggerKeywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
556
+ }, z.core.$strip>>>;
1270
557
  api: z.ZodOptional<z.ZodObject<{
1271
- type: z.ZodEnum<["rest", "mcp", "grpc", "websocket"]>;
558
+ type: z.ZodEnum<{
559
+ mcp: "mcp";
560
+ rest: "rest";
561
+ grpc: "grpc";
562
+ websocket: "websocket";
563
+ }>;
1272
564
  port: z.ZodOptional<z.ZodNumber>;
565
+ allowedPorts: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
1273
566
  pathPrefix: z.ZodOptional<z.ZodString>;
1274
567
  auth: z.ZodOptional<z.ZodObject<{
1275
- type: z.ZodEnum<["jwt", "apikey", "oauth2", "none"]>;
568
+ type: z.ZodEnum<{
569
+ none: "none";
570
+ apikey: "apikey";
571
+ jwt: "jwt";
572
+ oauth2: "oauth2";
573
+ }>;
1276
574
  jwksUri: z.ZodOptional<z.ZodString>;
1277
575
  header: z.ZodOptional<z.ZodString>;
1278
- }, "strip", z.ZodTypeAny, {
1279
- type: "jwt" | "apikey" | "none" | "oauth2";
1280
- header?: string | undefined;
1281
- jwksUri?: string | undefined;
1282
- }, {
1283
- type: "jwt" | "apikey" | "none" | "oauth2";
1284
- header?: string | undefined;
1285
- jwksUri?: string | undefined;
1286
- }>>;
576
+ }, z.core.$strip>>;
1287
577
  rateLimit: z.ZodOptional<z.ZodObject<{
1288
578
  requestsPerMinute: z.ZodOptional<z.ZodNumber>;
1289
579
  requestsPerHour: z.ZodOptional<z.ZodNumber>;
1290
- }, "strip", z.ZodTypeAny, {
1291
- requestsPerMinute?: number | undefined;
1292
- requestsPerHour?: number | undefined;
1293
- }, {
1294
- requestsPerMinute?: number | undefined;
1295
- requestsPerHour?: number | undefined;
1296
- }>>;
580
+ tokensPerMinute: z.ZodOptional<z.ZodNumber>;
581
+ }, z.core.$strip>>;
1297
582
  streaming: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1298
583
  healthEndpoint: z.ZodOptional<z.ZodString>;
1299
584
  metricsEndpoint: z.ZodOptional<z.ZodString>;
1300
- corsOrigins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1301
- /** Declares the conversational chat endpoint for this agent */
585
+ corsOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
1302
586
  chatEndpoint: z.ZodOptional<z.ZodObject<{
1303
587
  path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
1304
- protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<["openai-compatible", "custom"]>>>;
588
+ protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
589
+ custom: "custom";
590
+ "openai-compatible": "openai-compatible";
591
+ }>>>;
1305
592
  streaming: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1306
- sessionMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["stateful", "stateless"]>>>;
593
+ sessionMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
594
+ stateful: "stateful";
595
+ stateless: "stateless";
596
+ }>>>;
1307
597
  threadIdHeader: z.ZodDefault<z.ZodOptional<z.ZodString>>;
1308
- }, "strip", z.ZodTypeAny, {
1309
- path: string;
1310
- protocol: "custom" | "openai-compatible";
1311
- streaming: boolean;
1312
- sessionMode: "stateful" | "stateless";
1313
- threadIdHeader: string;
1314
- }, {
1315
- path?: string | undefined;
1316
- protocol?: "custom" | "openai-compatible" | undefined;
1317
- streaming?: boolean | undefined;
1318
- sessionMode?: "stateful" | "stateless" | undefined;
1319
- threadIdHeader?: string | undefined;
1320
- }>>;
1321
- }, "strip", z.ZodTypeAny, {
1322
- type: "mcp" | "rest" | "grpc" | "websocket";
1323
- streaming: boolean;
1324
- auth?: {
1325
- type: "jwt" | "apikey" | "none" | "oauth2";
1326
- header?: string | undefined;
1327
- jwksUri?: string | undefined;
1328
- } | undefined;
1329
- port?: number | undefined;
1330
- pathPrefix?: string | undefined;
1331
- rateLimit?: {
1332
- requestsPerMinute?: number | undefined;
1333
- requestsPerHour?: number | undefined;
1334
- } | undefined;
1335
- healthEndpoint?: string | undefined;
1336
- metricsEndpoint?: string | undefined;
1337
- corsOrigins?: string[] | undefined;
1338
- chatEndpoint?: {
1339
- path: string;
1340
- protocol: "custom" | "openai-compatible";
1341
- streaming: boolean;
1342
- sessionMode: "stateful" | "stateless";
1343
- threadIdHeader: string;
1344
- } | undefined;
1345
- }, {
1346
- type: "mcp" | "rest" | "grpc" | "websocket";
1347
- auth?: {
1348
- type: "jwt" | "apikey" | "none" | "oauth2";
1349
- header?: string | undefined;
1350
- jwksUri?: string | undefined;
1351
- } | undefined;
1352
- streaming?: boolean | undefined;
1353
- port?: number | undefined;
1354
- pathPrefix?: string | undefined;
1355
- rateLimit?: {
1356
- requestsPerMinute?: number | undefined;
1357
- requestsPerHour?: number | undefined;
1358
- } | undefined;
1359
- healthEndpoint?: string | undefined;
1360
- metricsEndpoint?: string | undefined;
1361
- corsOrigins?: string[] | undefined;
1362
- chatEndpoint?: {
1363
- path?: string | undefined;
1364
- protocol?: "custom" | "openai-compatible" | undefined;
1365
- streaming?: boolean | undefined;
1366
- sessionMode?: "stateful" | "stateless" | undefined;
1367
- threadIdHeader?: string | undefined;
1368
- } | undefined;
1369
- }>>;
598
+ }, z.core.$strip>>;
599
+ }, z.core.$strip>>;
1370
600
  skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
1371
601
  id: z.ZodString;
1372
602
  version: z.ZodOptional<z.ZodString>;
1373
- }, "strip", z.ZodTypeAny, {
1374
- id: string;
1375
- version?: string | undefined;
1376
- }, {
1377
- id: string;
1378
- version?: string | undefined;
1379
- }>, "many">>;
603
+ }, z.core.$strip>>>;
1380
604
  guardrails: z.ZodOptional<z.ZodObject<{
1381
- input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
605
+ input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1382
606
  type: z.ZodLiteral<"topic-filter">;
1383
- blockedTopics: z.ZodArray<z.ZodString, "many">;
1384
- action: z.ZodEnum<["reject", "warn", "log"]>;
607
+ blockedTopics: z.ZodArray<z.ZodString>;
608
+ action: z.ZodEnum<{
609
+ reject: "reject";
610
+ warn: "warn";
611
+ log: "log";
612
+ }>;
1385
613
  message: z.ZodOptional<z.ZodString>;
1386
- }, "strip", z.ZodTypeAny, {
1387
- type: "topic-filter";
1388
- blockedTopics: string[];
1389
- action: "reject" | "warn" | "log";
1390
- message?: string | undefined;
1391
- }, {
1392
- type: "topic-filter";
1393
- blockedTopics: string[];
1394
- action: "reject" | "warn" | "log";
1395
- message?: string | undefined;
1396
- }>, z.ZodObject<{
614
+ }, z.core.$strip>, z.ZodObject<{
1397
615
  type: z.ZodLiteral<"pii-detector">;
1398
- action: z.ZodEnum<["scrub", "reject", "warn"]>;
1399
- fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1400
- }, "strip", z.ZodTypeAny, {
1401
- type: "pii-detector";
1402
- action: "reject" | "warn" | "scrub";
1403
- fields?: string[] | undefined;
1404
- }, {
1405
- type: "pii-detector";
1406
- action: "reject" | "warn" | "scrub";
1407
- fields?: string[] | undefined;
1408
- }>, z.ZodObject<{
616
+ action: z.ZodEnum<{
617
+ scrub: "scrub";
618
+ reject: "reject";
619
+ warn: "warn";
620
+ }>;
621
+ fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
622
+ }, z.core.$strip>, z.ZodObject<{
1409
623
  type: z.ZodLiteral<"prompt-injection">;
1410
- action: z.ZodEnum<["reject", "warn"]>;
1411
- sensitivity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
1412
- }, "strip", z.ZodTypeAny, {
1413
- type: "prompt-injection";
1414
- action: "reject" | "warn";
1415
- sensitivity?: "low" | "medium" | "high" | undefined;
1416
- }, {
1417
- type: "prompt-injection";
1418
- action: "reject" | "warn";
1419
- sensitivity?: "low" | "medium" | "high" | undefined;
1420
- }>, z.ZodObject<{
624
+ action: z.ZodEnum<{
625
+ reject: "reject";
626
+ warn: "warn";
627
+ }>;
628
+ sensitivity: z.ZodOptional<z.ZodEnum<{
629
+ high: "high";
630
+ medium: "medium";
631
+ low: "low";
632
+ }>>;
633
+ }, z.core.$strip>, z.ZodObject<{
1421
634
  type: z.ZodLiteral<"custom">;
1422
635
  module: z.ZodString;
1423
636
  function: z.ZodString;
1424
- action: z.ZodEnum<["reject", "warn", "log"]>;
1425
- }, "strip", z.ZodTypeAny, {
1426
- function: string;
1427
- type: "custom";
1428
- module: string;
1429
- action: "reject" | "warn" | "log";
1430
- }, {
1431
- function: string;
1432
- type: "custom";
1433
- module: string;
1434
- action: "reject" | "warn" | "log";
1435
- }>]>, "many">>;
1436
- output: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
637
+ action: z.ZodEnum<{
638
+ reject: "reject";
639
+ warn: "warn";
640
+ log: "log";
641
+ }>;
642
+ }, z.core.$strip>], "type">>>;
643
+ output: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1437
644
  type: z.ZodLiteral<"hallucination-detector">;
1438
645
  threshold: z.ZodNumber;
1439
- action: z.ZodEnum<["reject", "retry", "warn"]>;
646
+ action: z.ZodEnum<{
647
+ reject: "reject";
648
+ warn: "warn";
649
+ retry: "retry";
650
+ }>;
1440
651
  maxRetries: z.ZodOptional<z.ZodNumber>;
1441
- }, "strip", z.ZodTypeAny, {
1442
- type: "hallucination-detector";
1443
- action: "reject" | "warn" | "retry";
1444
- threshold: number;
1445
- maxRetries?: number | undefined;
1446
- }, {
1447
- type: "hallucination-detector";
1448
- action: "reject" | "warn" | "retry";
1449
- threshold: number;
1450
- maxRetries?: number | undefined;
1451
- }>, z.ZodObject<{
652
+ }, z.core.$strip>, z.ZodObject<{
1452
653
  type: z.ZodLiteral<"toxicity-filter">;
1453
654
  threshold: z.ZodNumber;
1454
- action: z.ZodEnum<["reject", "warn"]>;
1455
- }, "strip", z.ZodTypeAny, {
1456
- type: "toxicity-filter";
1457
- action: "reject" | "warn";
1458
- threshold: number;
1459
- }, {
1460
- type: "toxicity-filter";
1461
- action: "reject" | "warn";
1462
- threshold: number;
1463
- }>, z.ZodObject<{
655
+ action: z.ZodEnum<{
656
+ reject: "reject";
657
+ warn: "warn";
658
+ }>;
659
+ }, z.core.$strip>, z.ZodObject<{
1464
660
  type: z.ZodLiteral<"pii-detector">;
1465
- action: z.ZodEnum<["scrub", "reject", "warn"]>;
1466
- fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1467
- }, "strip", z.ZodTypeAny, {
1468
- type: "pii-detector";
1469
- action: "reject" | "warn" | "scrub";
1470
- fields?: string[] | undefined;
1471
- }, {
1472
- type: "pii-detector";
1473
- action: "reject" | "warn" | "scrub";
1474
- fields?: string[] | undefined;
1475
- }>, z.ZodObject<{
661
+ action: z.ZodEnum<{
662
+ scrub: "scrub";
663
+ reject: "reject";
664
+ warn: "warn";
665
+ }>;
666
+ fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
667
+ }, z.core.$strip>, z.ZodObject<{
1476
668
  type: z.ZodLiteral<"custom">;
1477
669
  module: z.ZodString;
1478
670
  function: z.ZodString;
1479
- action: z.ZodEnum<["reject", "warn", "log"]>;
1480
- }, "strip", z.ZodTypeAny, {
1481
- function: string;
1482
- type: "custom";
1483
- module: string;
1484
- action: "reject" | "warn" | "log";
1485
- }, {
1486
- function: string;
1487
- type: "custom";
1488
- module: string;
1489
- action: "reject" | "warn" | "log";
1490
- }>]>, "many">>;
1491
- }, "strip", z.ZodTypeAny, {
1492
- input?: ({
1493
- type: "topic-filter";
1494
- blockedTopics: string[];
1495
- action: "reject" | "warn" | "log";
1496
- message?: string | undefined;
1497
- } | {
1498
- type: "pii-detector";
1499
- action: "reject" | "warn" | "scrub";
1500
- fields?: string[] | undefined;
1501
- } | {
1502
- type: "prompt-injection";
1503
- action: "reject" | "warn";
1504
- sensitivity?: "low" | "medium" | "high" | undefined;
1505
- } | {
1506
- function: string;
1507
- type: "custom";
1508
- module: string;
1509
- action: "reject" | "warn" | "log";
1510
- })[] | undefined;
1511
- output?: ({
1512
- type: "hallucination-detector";
1513
- action: "reject" | "warn" | "retry";
1514
- threshold: number;
1515
- maxRetries?: number | undefined;
1516
- } | {
1517
- type: "toxicity-filter";
1518
- action: "reject" | "warn";
1519
- threshold: number;
1520
- } | {
1521
- type: "pii-detector";
1522
- action: "reject" | "warn" | "scrub";
1523
- fields?: string[] | undefined;
1524
- } | {
1525
- function: string;
1526
- type: "custom";
1527
- module: string;
1528
- action: "reject" | "warn" | "log";
1529
- })[] | undefined;
1530
- }, {
1531
- input?: ({
1532
- type: "topic-filter";
1533
- blockedTopics: string[];
1534
- action: "reject" | "warn" | "log";
1535
- message?: string | undefined;
1536
- } | {
1537
- type: "pii-detector";
1538
- action: "reject" | "warn" | "scrub";
1539
- fields?: string[] | undefined;
1540
- } | {
1541
- type: "prompt-injection";
1542
- action: "reject" | "warn";
1543
- sensitivity?: "low" | "medium" | "high" | undefined;
1544
- } | {
1545
- function: string;
1546
- type: "custom";
1547
- module: string;
1548
- action: "reject" | "warn" | "log";
1549
- })[] | undefined;
1550
- output?: ({
1551
- type: "hallucination-detector";
1552
- action: "reject" | "warn" | "retry";
1553
- threshold: number;
1554
- maxRetries?: number | undefined;
1555
- } | {
1556
- type: "toxicity-filter";
1557
- action: "reject" | "warn";
1558
- threshold: number;
1559
- } | {
1560
- type: "pii-detector";
1561
- action: "reject" | "warn" | "scrub";
1562
- fields?: string[] | undefined;
1563
- } | {
1564
- function: string;
1565
- type: "custom";
1566
- module: string;
1567
- action: "reject" | "warn" | "log";
1568
- })[] | undefined;
1569
- }>>;
671
+ action: z.ZodEnum<{
672
+ reject: "reject";
673
+ warn: "warn";
674
+ log: "log";
675
+ }>;
676
+ }, z.core.$strip>], "type">>>;
677
+ }, z.core.$strip>>;
1570
678
  humanInTheLoop: z.ZodOptional<z.ZodObject<{
1571
679
  enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1572
- approvalRequired: z.ZodOptional<z.ZodArray<z.ZodEnum<["before-destructive-tool", "before-external-call", "on-low-confidence", "on-high-cost", "always"]>, "many">>;
680
+ approvalRequired: z.ZodOptional<z.ZodArray<z.ZodEnum<{
681
+ "before-destructive-tool": "before-destructive-tool";
682
+ "before-external-call": "before-external-call";
683
+ "on-low-confidence": "on-low-confidence";
684
+ "on-high-cost": "on-high-cost";
685
+ always: "always";
686
+ }>>>;
1573
687
  timeoutSeconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1574
- timeoutAction: z.ZodDefault<z.ZodOptional<z.ZodEnum<["reject", "proceed", "escalate"]>>>;
1575
- notifyVia: z.ZodOptional<z.ZodArray<z.ZodEnum<["slack", "email", "webhook", "console"]>, "many">>;
688
+ timeoutAction: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
689
+ reject: "reject";
690
+ proceed: "proceed";
691
+ escalate: "escalate";
692
+ }>>>;
693
+ notifyVia: z.ZodOptional<z.ZodArray<z.ZodEnum<{
694
+ webhook: "webhook";
695
+ slack: "slack";
696
+ email: "email";
697
+ console: "console";
698
+ }>>>;
1576
699
  webhookUrl: z.ZodOptional<z.ZodString>;
1577
- }, "strip", z.ZodTypeAny, {
1578
- timeoutSeconds: number;
1579
- enabled: boolean;
1580
- timeoutAction: "reject" | "proceed" | "escalate";
1581
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
1582
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
1583
- webhookUrl?: string | undefined;
1584
- }, {
1585
- timeoutSeconds?: number | undefined;
1586
- enabled?: boolean | undefined;
1587
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
1588
- timeoutAction?: "reject" | "proceed" | "escalate" | undefined;
1589
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
1590
- webhookUrl?: string | undefined;
1591
- }>>;
700
+ }, z.core.$strip>>;
1592
701
  evaluation: z.ZodOptional<z.ZodObject<{
1593
- framework: z.ZodEnum<["deepeval", "braintrust", "langsmith", "ragas", "custom"]>;
702
+ framework: z.ZodOptional<z.ZodEnum<{
703
+ custom: "custom";
704
+ deepeval: "deepeval";
705
+ braintrust: "braintrust";
706
+ langsmith: "langsmith";
707
+ ragas: "ragas";
708
+ }>>;
709
+ live: z.ZodOptional<z.ZodObject<{
710
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
711
+ custom: "custom";
712
+ faithfulness: "faithfulness";
713
+ answer_relevancy: "answer_relevancy";
714
+ hallucination: "hallucination";
715
+ toxicity: "toxicity";
716
+ context_precision: "context_precision";
717
+ bias: "bias";
718
+ grounded: "grounded";
719
+ pii_leakage: "pii_leakage";
720
+ prompt_injection: "prompt_injection";
721
+ }>>>;
722
+ thresholds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
723
+ custom: z.ZodOptional<z.ZodObject<{
724
+ name: z.ZodString;
725
+ rubric: z.ZodString;
726
+ }, z.core.$strip>>;
727
+ }, z.core.$strip>>;
728
+ custom: z.ZodOptional<z.ZodObject<{
729
+ name: z.ZodString;
730
+ rubric: z.ZodString;
731
+ }, z.core.$strip>>;
1594
732
  datasets: z.ZodOptional<z.ZodArray<z.ZodObject<{
1595
733
  name: z.ZodString;
1596
734
  path: z.ZodString;
1597
- metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["faithfulness", "answer_relevancy", "answer_similarity", "hallucination", "toxicity", "context_precision", "context_recall", "bias", "custom"]>, "many">>;
1598
- }, "strip", z.ZodTypeAny, {
1599
- name: string;
1600
- path: string;
1601
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1602
- }, {
1603
- name: string;
1604
- path: string;
1605
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1606
- }>, "many">>;
1607
- metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["faithfulness", "answer_relevancy", "answer_similarity", "hallucination", "toxicity", "context_precision", "context_recall", "bias", "custom"]>, "many">>;
735
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
736
+ custom: "custom";
737
+ faithfulness: "faithfulness";
738
+ answer_relevancy: "answer_relevancy";
739
+ answer_similarity: "answer_similarity";
740
+ hallucination: "hallucination";
741
+ toxicity: "toxicity";
742
+ context_precision: "context_precision";
743
+ context_recall: "context_recall";
744
+ bias: "bias";
745
+ grounded: "grounded";
746
+ pii_leakage: "pii_leakage";
747
+ prompt_injection: "prompt_injection";
748
+ }>>>;
749
+ }, z.core.$strip>>>;
750
+ metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<{
751
+ custom: "custom";
752
+ faithfulness: "faithfulness";
753
+ answer_relevancy: "answer_relevancy";
754
+ answer_similarity: "answer_similarity";
755
+ hallucination: "hallucination";
756
+ toxicity: "toxicity";
757
+ context_precision: "context_precision";
758
+ context_recall: "context_recall";
759
+ bias: "bias";
760
+ grounded: "grounded";
761
+ pii_leakage: "pii_leakage";
762
+ prompt_injection: "prompt_injection";
763
+ }>>>;
1608
764
  thresholds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
1609
765
  ciGate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1610
- }, "strip", z.ZodTypeAny, {
1611
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
1612
- ciGate: boolean;
1613
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1614
- datasets?: {
1615
- name: string;
1616
- path: string;
1617
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1618
- }[] | undefined;
1619
- thresholds?: Record<string, number> | undefined;
1620
- }, {
1621
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
1622
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1623
- datasets?: {
1624
- name: string;
1625
- path: string;
1626
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1627
- }[] | undefined;
1628
- thresholds?: Record<string, number> | undefined;
1629
- ciGate?: boolean | undefined;
1630
- }>>;
766
+ }, z.core.$strip>>;
1631
767
  observability: z.ZodOptional<z.ZodObject<{
1632
768
  tracing: z.ZodOptional<z.ZodObject<{
1633
- backend: z.ZodEnum<["langfuse", "langsmith", "agentops", "otel", "honeycomb", "datadog"]>;
769
+ backend: z.ZodEnum<{
770
+ langsmith: "langsmith";
771
+ langfuse: "langfuse";
772
+ agentops: "agentops";
773
+ otel: "otel";
774
+ honeycomb: "honeycomb";
775
+ datadog: "datadog";
776
+ }>;
1634
777
  endpoint: z.ZodOptional<z.ZodString>;
1635
778
  publicKey: z.ZodOptional<z.ZodString>;
1636
779
  secretKey: z.ZodOptional<z.ZodString>;
1637
780
  sampleRate: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1638
- }, "strip", z.ZodTypeAny, {
1639
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
1640
- sampleRate: number;
1641
- endpoint?: string | undefined;
1642
- publicKey?: string | undefined;
1643
- secretKey?: string | undefined;
1644
- }, {
1645
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
1646
- endpoint?: string | undefined;
1647
- publicKey?: string | undefined;
1648
- secretKey?: string | undefined;
1649
- sampleRate?: number | undefined;
1650
- }>>;
781
+ }, z.core.$strip>>;
1651
782
  metrics: z.ZodOptional<z.ZodObject<{
1652
- backend: z.ZodEnum<["opentelemetry", "prometheus", "datadog"]>;
783
+ backend: z.ZodEnum<{
784
+ datadog: "datadog";
785
+ opentelemetry: "opentelemetry";
786
+ prometheus: "prometheus";
787
+ }>;
1653
788
  endpoint: z.ZodOptional<z.ZodString>;
1654
789
  serviceName: z.ZodOptional<z.ZodString>;
1655
- }, "strip", z.ZodTypeAny, {
1656
- backend: "datadog" | "opentelemetry" | "prometheus";
1657
- endpoint?: string | undefined;
1658
- serviceName?: string | undefined;
1659
- }, {
1660
- backend: "datadog" | "opentelemetry" | "prometheus";
1661
- endpoint?: string | undefined;
1662
- serviceName?: string | undefined;
1663
- }>>;
790
+ }, z.core.$strip>>;
1664
791
  logging: z.ZodOptional<z.ZodObject<{
1665
- level: z.ZodDefault<z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>>;
792
+ level: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
793
+ info: "info";
794
+ error: "error";
795
+ warn: "warn";
796
+ debug: "debug";
797
+ }>>>;
1666
798
  structured: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1667
- redactFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1668
- }, "strip", z.ZodTypeAny, {
1669
- level: "warn" | "debug" | "info" | "error";
1670
- structured: boolean;
1671
- redactFields?: string[] | undefined;
1672
- }, {
1673
- level?: "warn" | "debug" | "info" | "error" | undefined;
1674
- structured?: boolean | undefined;
1675
- redactFields?: string[] | undefined;
1676
- }>>;
1677
- }, "strip", z.ZodTypeAny, {
1678
- metrics?: {
1679
- backend: "datadog" | "opentelemetry" | "prometheus";
1680
- endpoint?: string | undefined;
1681
- serviceName?: string | undefined;
1682
- } | undefined;
1683
- tracing?: {
1684
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
1685
- sampleRate: number;
1686
- endpoint?: string | undefined;
1687
- publicKey?: string | undefined;
1688
- secretKey?: string | undefined;
1689
- } | undefined;
1690
- logging?: {
1691
- level: "warn" | "debug" | "info" | "error";
1692
- structured: boolean;
1693
- redactFields?: string[] | undefined;
1694
- } | undefined;
1695
- }, {
1696
- metrics?: {
1697
- backend: "datadog" | "opentelemetry" | "prometheus";
1698
- endpoint?: string | undefined;
1699
- serviceName?: string | undefined;
1700
- } | undefined;
1701
- tracing?: {
1702
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
1703
- endpoint?: string | undefined;
1704
- publicKey?: string | undefined;
1705
- secretKey?: string | undefined;
1706
- sampleRate?: number | undefined;
1707
- } | undefined;
1708
- logging?: {
1709
- level?: "warn" | "debug" | "info" | "error" | undefined;
1710
- structured?: boolean | undefined;
1711
- redactFields?: string[] | undefined;
1712
- } | undefined;
1713
- }>>;
799
+ redactFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
800
+ }, z.core.$strip>>;
801
+ }, z.core.$strip>>;
1714
802
  compliance: z.ZodOptional<z.ZodObject<{
1715
- packs: z.ZodOptional<z.ZodArray<z.ZodEnum<["owasp-llm-top10", "memory-hygiene", "model-resilience", "evaluation-coverage", "observability", "metadata-quality"]>, "many">>;
803
+ packs: z.ZodOptional<z.ZodArray<z.ZodEnum<{
804
+ observability: "observability";
805
+ "owasp-llm-top10": "owasp-llm-top10";
806
+ "memory-hygiene": "memory-hygiene";
807
+ "model-resilience": "model-resilience";
808
+ "evaluation-coverage": "evaluation-coverage";
809
+ "metadata-quality": "metadata-quality";
810
+ }>>>;
1716
811
  suppressions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1717
812
  rule: z.ZodString;
1718
813
  reason: z.ZodString;
1719
814
  approvedBy: z.ZodOptional<z.ZodString>;
1720
815
  expires: z.ZodOptional<z.ZodString>;
1721
- }, "strip", z.ZodTypeAny, {
1722
- rule: string;
1723
- reason: string;
1724
- approvedBy?: string | undefined;
1725
- expires?: string | undefined;
1726
- }, {
1727
- rule: string;
1728
- reason: string;
1729
- approvedBy?: string | undefined;
1730
- expires?: string | undefined;
1731
- }>, "many">>;
1732
- auditSchedule: z.ZodOptional<z.ZodEnum<["daily", "weekly", "monthly", "on-change"]>>;
1733
- }, "strip", z.ZodTypeAny, {
1734
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
1735
- suppressions?: {
1736
- rule: string;
1737
- reason: string;
1738
- approvedBy?: string | undefined;
1739
- expires?: string | undefined;
1740
- }[] | undefined;
1741
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
1742
- }, {
1743
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
1744
- suppressions?: {
1745
- rule: string;
1746
- reason: string;
1747
- approvedBy?: string | undefined;
1748
- expires?: string | undefined;
1749
- }[] | undefined;
1750
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
1751
- }>>;
816
+ }, z.core.$strip>>>;
817
+ auditSchedule: z.ZodOptional<z.ZodEnum<{
818
+ daily: "daily";
819
+ weekly: "weekly";
820
+ monthly: "monthly";
821
+ "on-change": "on-change";
822
+ }>>;
823
+ }, z.core.$strip>>;
1752
824
  requires: z.ZodOptional<z.ZodObject<{
1753
- envVars: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
825
+ envVars: z.ZodOptional<z.ZodArray<z.ZodString>>;
1754
826
  services: z.ZodOptional<z.ZodArray<z.ZodObject<{
1755
- type: z.ZodEnum<["postgres", "redis", "mysql", "mongodb", "elasticsearch"]>;
827
+ type: z.ZodEnum<{
828
+ redis: "redis";
829
+ postgres: "postgres";
830
+ mongodb: "mongodb";
831
+ mysql: "mysql";
832
+ elasticsearch: "elasticsearch";
833
+ }>;
1756
834
  connection: z.ZodString;
1757
- }, "strip", z.ZodTypeAny, {
1758
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
1759
- connection: string;
1760
- }, {
1761
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
1762
- connection: string;
1763
- }>, "many">>;
835
+ }, z.core.$strip>>>;
1764
836
  minimumMemoryMB: z.ZodOptional<z.ZodNumber>;
1765
837
  nodeVersion: z.ZodOptional<z.ZodString>;
1766
838
  pythonVersion: z.ZodOptional<z.ZodString>;
1767
- }, "strip", z.ZodTypeAny, {
1768
- envVars?: string[] | undefined;
1769
- services?: {
1770
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
1771
- connection: string;
1772
- }[] | undefined;
1773
- minimumMemoryMB?: number | undefined;
1774
- nodeVersion?: string | undefined;
1775
- pythonVersion?: string | undefined;
1776
- }, {
1777
- envVars?: string[] | undefined;
1778
- services?: {
1779
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
1780
- connection: string;
1781
- }[] | undefined;
1782
- minimumMemoryMB?: number | undefined;
1783
- nodeVersion?: string | undefined;
1784
- pythonVersion?: string | undefined;
1785
- }>>;
1786
- }, "strip", z.ZodTypeAny, {
1787
- model: {
1788
- provider: string;
1789
- id: string;
1790
- apiKey: string;
1791
- parameters?: {
1792
- temperature?: number | undefined;
1793
- maxTokens?: number | undefined;
1794
- topP?: number | undefined;
1795
- frequencyPenalty?: number | undefined;
1796
- presencePenalty?: number | undefined;
1797
- } | undefined;
1798
- fallback?: {
1799
- provider: string;
1800
- id: string;
1801
- apiKey: string;
1802
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
1803
- maxRetries?: number | undefined;
1804
- } | undefined;
1805
- costControls?: {
1806
- maxMonthlyUSD?: number | undefined;
1807
- alertAtUSD?: number | undefined;
1808
- } | undefined;
1809
- };
1810
- prompts: {
1811
- system: string;
1812
- hotReload: boolean;
1813
- fallback?: string | undefined;
1814
- variables?: {
1815
- name: string;
1816
- value: string;
1817
- }[] | undefined;
1818
- };
1819
- mcp?: {
1820
- servers: {
1821
- name: string;
1822
- transport: "stdio" | "sse" | "http";
1823
- command?: string | undefined;
1824
- args?: string[] | undefined;
1825
- url?: string | undefined;
1826
- env?: Record<string, string> | undefined;
1827
- healthCheck?: {
1828
- timeoutSeconds: number;
1829
- } | undefined;
1830
- }[];
1831
- } | undefined;
1832
- observability?: {
1833
- metrics?: {
1834
- backend: "datadog" | "opentelemetry" | "prometheus";
1835
- endpoint?: string | undefined;
1836
- serviceName?: string | undefined;
1837
- } | undefined;
1838
- tracing?: {
1839
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
1840
- sampleRate: number;
1841
- endpoint?: string | undefined;
1842
- publicKey?: string | undefined;
1843
- secretKey?: string | undefined;
1844
- } | undefined;
1845
- logging?: {
1846
- level: "warn" | "debug" | "info" | "error";
1847
- structured: boolean;
1848
- redactFields?: string[] | undefined;
1849
- } | undefined;
1850
- } | undefined;
1851
- tools?: {
1852
- name: string;
1853
- description: string;
1854
- type: "function" | "mcp" | "builtin";
1855
- function?: string | undefined;
1856
- module?: string | undefined;
1857
- annotations?: {
1858
- readOnlyHint?: boolean | undefined;
1859
- destructiveHint?: boolean | undefined;
1860
- idempotentHint?: boolean | undefined;
1861
- openWorldHint?: boolean | undefined;
1862
- } | undefined;
1863
- }[] | undefined;
1864
- memory?: {
1865
- shortTerm?: {
1866
- backend: "in-memory" | "redis" | "sqlite";
1867
- maxTokens?: number | undefined;
1868
- maxTurns?: number | undefined;
1869
- ttlSeconds?: number | undefined;
1870
- connection?: string | undefined;
1871
- } | undefined;
1872
- longTerm?: {
1873
- backend: "sqlite" | "postgres" | "mongodb";
1874
- connectionString: string;
1875
- table?: string | undefined;
1876
- ttlDays?: number | undefined;
1877
- } | undefined;
1878
- vector?: {
1879
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
1880
- dimension: number;
1881
- apiKey?: string | undefined;
1882
- connectionString?: string | undefined;
1883
- topK?: number | undefined;
1884
- namespace?: string | undefined;
1885
- } | undefined;
1886
- hygiene?: {
1887
- auditLog: boolean;
1888
- piiScrubFields?: string[] | undefined;
1889
- retentionPolicy?: string | undefined;
1890
- } | undefined;
1891
- } | undefined;
1892
- subagents?: {
1893
- name: string;
1894
- ref: {
1895
- agentspec: string;
1896
- } | {
1897
- a2a: {
1898
- url: string;
1899
- auth?: {
1900
- type: "bearer" | "apikey" | "none";
1901
- token?: string | undefined;
1902
- header?: string | undefined;
1903
- } | undefined;
1904
- };
1905
- };
1906
- invocation: "parallel" | "sequential" | "on-demand";
1907
- passContext: boolean;
1908
- triggerKeywords?: string[] | undefined;
1909
- }[] | undefined;
1910
- api?: {
1911
- type: "mcp" | "rest" | "grpc" | "websocket";
1912
- streaming: boolean;
1913
- auth?: {
1914
- type: "jwt" | "apikey" | "none" | "oauth2";
1915
- header?: string | undefined;
1916
- jwksUri?: string | undefined;
1917
- } | undefined;
1918
- port?: number | undefined;
1919
- pathPrefix?: string | undefined;
1920
- rateLimit?: {
1921
- requestsPerMinute?: number | undefined;
1922
- requestsPerHour?: number | undefined;
1923
- } | undefined;
1924
- healthEndpoint?: string | undefined;
1925
- metricsEndpoint?: string | undefined;
1926
- corsOrigins?: string[] | undefined;
1927
- chatEndpoint?: {
1928
- path: string;
1929
- protocol: "custom" | "openai-compatible";
1930
- streaming: boolean;
1931
- sessionMode: "stateful" | "stateless";
1932
- threadIdHeader: string;
1933
- } | undefined;
1934
- } | undefined;
1935
- skills?: {
1936
- id: string;
1937
- version?: string | undefined;
1938
- }[] | undefined;
1939
- guardrails?: {
1940
- input?: ({
1941
- type: "topic-filter";
1942
- blockedTopics: string[];
1943
- action: "reject" | "warn" | "log";
1944
- message?: string | undefined;
1945
- } | {
1946
- type: "pii-detector";
1947
- action: "reject" | "warn" | "scrub";
1948
- fields?: string[] | undefined;
1949
- } | {
1950
- type: "prompt-injection";
1951
- action: "reject" | "warn";
1952
- sensitivity?: "low" | "medium" | "high" | undefined;
1953
- } | {
1954
- function: string;
1955
- type: "custom";
1956
- module: string;
1957
- action: "reject" | "warn" | "log";
1958
- })[] | undefined;
1959
- output?: ({
1960
- type: "hallucination-detector";
1961
- action: "reject" | "warn" | "retry";
1962
- threshold: number;
1963
- maxRetries?: number | undefined;
1964
- } | {
1965
- type: "toxicity-filter";
1966
- action: "reject" | "warn";
1967
- threshold: number;
1968
- } | {
1969
- type: "pii-detector";
1970
- action: "reject" | "warn" | "scrub";
1971
- fields?: string[] | undefined;
1972
- } | {
1973
- function: string;
1974
- type: "custom";
1975
- module: string;
1976
- action: "reject" | "warn" | "log";
1977
- })[] | undefined;
1978
- } | undefined;
1979
- humanInTheLoop?: {
1980
- timeoutSeconds: number;
1981
- enabled: boolean;
1982
- timeoutAction: "reject" | "proceed" | "escalate";
1983
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
1984
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
1985
- webhookUrl?: string | undefined;
1986
- } | undefined;
1987
- evaluation?: {
1988
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
1989
- ciGate: boolean;
1990
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1991
- datasets?: {
1992
- name: string;
1993
- path: string;
1994
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
1995
- }[] | undefined;
1996
- thresholds?: Record<string, number> | undefined;
1997
- } | undefined;
1998
- compliance?: {
1999
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
2000
- suppressions?: {
2001
- rule: string;
2002
- reason: string;
2003
- approvedBy?: string | undefined;
2004
- expires?: string | undefined;
2005
- }[] | undefined;
2006
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
2007
- } | undefined;
2008
- requires?: {
2009
- envVars?: string[] | undefined;
2010
- services?: {
2011
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
2012
- connection: string;
2013
- }[] | undefined;
2014
- minimumMemoryMB?: number | undefined;
2015
- nodeVersion?: string | undefined;
2016
- pythonVersion?: string | undefined;
2017
- } | undefined;
2018
- }, {
2019
- model: {
2020
- provider: string;
2021
- id: string;
2022
- apiKey: string;
2023
- parameters?: {
2024
- temperature?: number | undefined;
2025
- maxTokens?: number | undefined;
2026
- topP?: number | undefined;
2027
- frequencyPenalty?: number | undefined;
2028
- presencePenalty?: number | undefined;
2029
- } | undefined;
2030
- fallback?: {
2031
- provider: string;
2032
- id: string;
2033
- apiKey: string;
2034
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
2035
- maxRetries?: number | undefined;
2036
- } | undefined;
2037
- costControls?: {
2038
- maxMonthlyUSD?: number | undefined;
2039
- alertAtUSD?: number | undefined;
2040
- } | undefined;
2041
- };
2042
- prompts: {
2043
- system: string;
2044
- fallback?: string | undefined;
2045
- hotReload?: boolean | undefined;
2046
- variables?: {
2047
- name: string;
2048
- value: string;
2049
- }[] | undefined;
2050
- };
2051
- mcp?: {
2052
- servers: {
2053
- name: string;
2054
- transport: "stdio" | "sse" | "http";
2055
- command?: string | undefined;
2056
- args?: string[] | undefined;
2057
- url?: string | undefined;
2058
- env?: Record<string, string> | undefined;
2059
- healthCheck?: {
2060
- timeoutSeconds?: number | undefined;
2061
- } | undefined;
2062
- }[];
2063
- } | undefined;
2064
- observability?: {
2065
- metrics?: {
2066
- backend: "datadog" | "opentelemetry" | "prometheus";
2067
- endpoint?: string | undefined;
2068
- serviceName?: string | undefined;
2069
- } | undefined;
2070
- tracing?: {
2071
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
2072
- endpoint?: string | undefined;
2073
- publicKey?: string | undefined;
2074
- secretKey?: string | undefined;
2075
- sampleRate?: number | undefined;
2076
- } | undefined;
2077
- logging?: {
2078
- level?: "warn" | "debug" | "info" | "error" | undefined;
2079
- structured?: boolean | undefined;
2080
- redactFields?: string[] | undefined;
2081
- } | undefined;
2082
- } | undefined;
2083
- tools?: {
2084
- name: string;
2085
- description: string;
2086
- type: "function" | "mcp" | "builtin";
2087
- function?: string | undefined;
2088
- module?: string | undefined;
2089
- annotations?: {
2090
- readOnlyHint?: boolean | undefined;
2091
- destructiveHint?: boolean | undefined;
2092
- idempotentHint?: boolean | undefined;
2093
- openWorldHint?: boolean | undefined;
2094
- } | undefined;
2095
- }[] | undefined;
2096
- memory?: {
2097
- shortTerm?: {
2098
- backend: "in-memory" | "redis" | "sqlite";
2099
- maxTokens?: number | undefined;
2100
- maxTurns?: number | undefined;
2101
- ttlSeconds?: number | undefined;
2102
- connection?: string | undefined;
2103
- } | undefined;
2104
- longTerm?: {
2105
- backend: "sqlite" | "postgres" | "mongodb";
2106
- connectionString: string;
2107
- table?: string | undefined;
2108
- ttlDays?: number | undefined;
2109
- } | undefined;
2110
- vector?: {
2111
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
2112
- dimension: number;
2113
- apiKey?: string | undefined;
2114
- connectionString?: string | undefined;
2115
- topK?: number | undefined;
2116
- namespace?: string | undefined;
2117
- } | undefined;
2118
- hygiene?: {
2119
- piiScrubFields?: string[] | undefined;
2120
- auditLog?: boolean | undefined;
2121
- retentionPolicy?: string | undefined;
2122
- } | undefined;
2123
- } | undefined;
2124
- subagents?: {
2125
- name: string;
2126
- ref: {
2127
- agentspec: string;
2128
- } | {
2129
- a2a: {
2130
- url: string;
2131
- auth?: {
2132
- type: "bearer" | "apikey" | "none";
2133
- token?: string | undefined;
2134
- header?: string | undefined;
2135
- } | undefined;
2136
- };
2137
- };
2138
- invocation: "parallel" | "sequential" | "on-demand";
2139
- passContext?: boolean | undefined;
2140
- triggerKeywords?: string[] | undefined;
2141
- }[] | undefined;
2142
- api?: {
2143
- type: "mcp" | "rest" | "grpc" | "websocket";
2144
- auth?: {
2145
- type: "jwt" | "apikey" | "none" | "oauth2";
2146
- header?: string | undefined;
2147
- jwksUri?: string | undefined;
2148
- } | undefined;
2149
- streaming?: boolean | undefined;
2150
- port?: number | undefined;
2151
- pathPrefix?: string | undefined;
2152
- rateLimit?: {
2153
- requestsPerMinute?: number | undefined;
2154
- requestsPerHour?: number | undefined;
2155
- } | undefined;
2156
- healthEndpoint?: string | undefined;
2157
- metricsEndpoint?: string | undefined;
2158
- corsOrigins?: string[] | undefined;
2159
- chatEndpoint?: {
2160
- path?: string | undefined;
2161
- protocol?: "custom" | "openai-compatible" | undefined;
2162
- streaming?: boolean | undefined;
2163
- sessionMode?: "stateful" | "stateless" | undefined;
2164
- threadIdHeader?: string | undefined;
2165
- } | undefined;
2166
- } | undefined;
2167
- skills?: {
2168
- id: string;
2169
- version?: string | undefined;
2170
- }[] | undefined;
2171
- guardrails?: {
2172
- input?: ({
2173
- type: "topic-filter";
2174
- blockedTopics: string[];
2175
- action: "reject" | "warn" | "log";
2176
- message?: string | undefined;
2177
- } | {
2178
- type: "pii-detector";
2179
- action: "reject" | "warn" | "scrub";
2180
- fields?: string[] | undefined;
2181
- } | {
2182
- type: "prompt-injection";
2183
- action: "reject" | "warn";
2184
- sensitivity?: "low" | "medium" | "high" | undefined;
2185
- } | {
2186
- function: string;
2187
- type: "custom";
2188
- module: string;
2189
- action: "reject" | "warn" | "log";
2190
- })[] | undefined;
2191
- output?: ({
2192
- type: "hallucination-detector";
2193
- action: "reject" | "warn" | "retry";
2194
- threshold: number;
2195
- maxRetries?: number | undefined;
2196
- } | {
2197
- type: "toxicity-filter";
2198
- action: "reject" | "warn";
2199
- threshold: number;
2200
- } | {
2201
- type: "pii-detector";
2202
- action: "reject" | "warn" | "scrub";
2203
- fields?: string[] | undefined;
2204
- } | {
2205
- function: string;
2206
- type: "custom";
2207
- module: string;
2208
- action: "reject" | "warn" | "log";
2209
- })[] | undefined;
2210
- } | undefined;
2211
- humanInTheLoop?: {
2212
- timeoutSeconds?: number | undefined;
2213
- enabled?: boolean | undefined;
2214
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
2215
- timeoutAction?: "reject" | "proceed" | "escalate" | undefined;
2216
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
2217
- webhookUrl?: string | undefined;
2218
- } | undefined;
2219
- evaluation?: {
2220
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
2221
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2222
- datasets?: {
2223
- name: string;
2224
- path: string;
2225
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2226
- }[] | undefined;
2227
- thresholds?: Record<string, number> | undefined;
2228
- ciGate?: boolean | undefined;
2229
- } | undefined;
2230
- compliance?: {
2231
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
2232
- suppressions?: {
2233
- rule: string;
2234
- reason: string;
2235
- approvedBy?: string | undefined;
2236
- expires?: string | undefined;
2237
- }[] | undefined;
2238
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
2239
- } | undefined;
2240
- requires?: {
2241
- envVars?: string[] | undefined;
2242
- services?: {
2243
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
2244
- connection: string;
2245
- }[] | undefined;
2246
- minimumMemoryMB?: number | undefined;
2247
- nodeVersion?: string | undefined;
2248
- pythonVersion?: string | undefined;
2249
- } | undefined;
2250
- }>;
2251
- }, "strip", z.ZodTypeAny, {
2252
- apiVersion: "agentspec.io/v1";
2253
- kind: "AgentSpec";
2254
- metadata: {
2255
- name: string;
2256
- version: string;
2257
- description: string;
2258
- tags?: string[] | undefined;
2259
- author?: string | undefined;
2260
- license?: string | undefined;
2261
- };
2262
- spec: {
2263
- model: {
2264
- provider: string;
2265
- id: string;
2266
- apiKey: string;
2267
- parameters?: {
2268
- temperature?: number | undefined;
2269
- maxTokens?: number | undefined;
2270
- topP?: number | undefined;
2271
- frequencyPenalty?: number | undefined;
2272
- presencePenalty?: number | undefined;
2273
- } | undefined;
2274
- fallback?: {
2275
- provider: string;
2276
- id: string;
2277
- apiKey: string;
2278
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
2279
- maxRetries?: number | undefined;
2280
- } | undefined;
2281
- costControls?: {
2282
- maxMonthlyUSD?: number | undefined;
2283
- alertAtUSD?: number | undefined;
2284
- } | undefined;
2285
- };
2286
- prompts: {
2287
- system: string;
2288
- hotReload: boolean;
2289
- fallback?: string | undefined;
2290
- variables?: {
2291
- name: string;
2292
- value: string;
2293
- }[] | undefined;
2294
- };
2295
- mcp?: {
2296
- servers: {
2297
- name: string;
2298
- transport: "stdio" | "sse" | "http";
2299
- command?: string | undefined;
2300
- args?: string[] | undefined;
2301
- url?: string | undefined;
2302
- env?: Record<string, string> | undefined;
2303
- healthCheck?: {
2304
- timeoutSeconds: number;
2305
- } | undefined;
2306
- }[];
2307
- } | undefined;
2308
- observability?: {
2309
- metrics?: {
2310
- backend: "datadog" | "opentelemetry" | "prometheus";
2311
- endpoint?: string | undefined;
2312
- serviceName?: string | undefined;
2313
- } | undefined;
2314
- tracing?: {
2315
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
2316
- sampleRate: number;
2317
- endpoint?: string | undefined;
2318
- publicKey?: string | undefined;
2319
- secretKey?: string | undefined;
2320
- } | undefined;
2321
- logging?: {
2322
- level: "warn" | "debug" | "info" | "error";
2323
- structured: boolean;
2324
- redactFields?: string[] | undefined;
2325
- } | undefined;
2326
- } | undefined;
2327
- tools?: {
2328
- name: string;
2329
- description: string;
2330
- type: "function" | "mcp" | "builtin";
2331
- function?: string | undefined;
2332
- module?: string | undefined;
2333
- annotations?: {
2334
- readOnlyHint?: boolean | undefined;
2335
- destructiveHint?: boolean | undefined;
2336
- idempotentHint?: boolean | undefined;
2337
- openWorldHint?: boolean | undefined;
2338
- } | undefined;
2339
- }[] | undefined;
2340
- memory?: {
2341
- shortTerm?: {
2342
- backend: "in-memory" | "redis" | "sqlite";
2343
- maxTokens?: number | undefined;
2344
- maxTurns?: number | undefined;
2345
- ttlSeconds?: number | undefined;
2346
- connection?: string | undefined;
2347
- } | undefined;
2348
- longTerm?: {
2349
- backend: "sqlite" | "postgres" | "mongodb";
2350
- connectionString: string;
2351
- table?: string | undefined;
2352
- ttlDays?: number | undefined;
2353
- } | undefined;
2354
- vector?: {
2355
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
2356
- dimension: number;
2357
- apiKey?: string | undefined;
2358
- connectionString?: string | undefined;
2359
- topK?: number | undefined;
2360
- namespace?: string | undefined;
2361
- } | undefined;
2362
- hygiene?: {
2363
- auditLog: boolean;
2364
- piiScrubFields?: string[] | undefined;
2365
- retentionPolicy?: string | undefined;
2366
- } | undefined;
2367
- } | undefined;
2368
- subagents?: {
2369
- name: string;
2370
- ref: {
2371
- agentspec: string;
2372
- } | {
2373
- a2a: {
2374
- url: string;
2375
- auth?: {
2376
- type: "bearer" | "apikey" | "none";
2377
- token?: string | undefined;
2378
- header?: string | undefined;
2379
- } | undefined;
2380
- };
2381
- };
2382
- invocation: "parallel" | "sequential" | "on-demand";
2383
- passContext: boolean;
2384
- triggerKeywords?: string[] | undefined;
2385
- }[] | undefined;
2386
- api?: {
2387
- type: "mcp" | "rest" | "grpc" | "websocket";
2388
- streaming: boolean;
2389
- auth?: {
2390
- type: "jwt" | "apikey" | "none" | "oauth2";
2391
- header?: string | undefined;
2392
- jwksUri?: string | undefined;
2393
- } | undefined;
2394
- port?: number | undefined;
2395
- pathPrefix?: string | undefined;
2396
- rateLimit?: {
2397
- requestsPerMinute?: number | undefined;
2398
- requestsPerHour?: number | undefined;
2399
- } | undefined;
2400
- healthEndpoint?: string | undefined;
2401
- metricsEndpoint?: string | undefined;
2402
- corsOrigins?: string[] | undefined;
2403
- chatEndpoint?: {
2404
- path: string;
2405
- protocol: "custom" | "openai-compatible";
2406
- streaming: boolean;
2407
- sessionMode: "stateful" | "stateless";
2408
- threadIdHeader: string;
2409
- } | undefined;
2410
- } | undefined;
2411
- skills?: {
2412
- id: string;
2413
- version?: string | undefined;
2414
- }[] | undefined;
2415
- guardrails?: {
2416
- input?: ({
2417
- type: "topic-filter";
2418
- blockedTopics: string[];
2419
- action: "reject" | "warn" | "log";
2420
- message?: string | undefined;
2421
- } | {
2422
- type: "pii-detector";
2423
- action: "reject" | "warn" | "scrub";
2424
- fields?: string[] | undefined;
2425
- } | {
2426
- type: "prompt-injection";
2427
- action: "reject" | "warn";
2428
- sensitivity?: "low" | "medium" | "high" | undefined;
2429
- } | {
2430
- function: string;
2431
- type: "custom";
2432
- module: string;
2433
- action: "reject" | "warn" | "log";
2434
- })[] | undefined;
2435
- output?: ({
2436
- type: "hallucination-detector";
2437
- action: "reject" | "warn" | "retry";
2438
- threshold: number;
2439
- maxRetries?: number | undefined;
2440
- } | {
2441
- type: "toxicity-filter";
2442
- action: "reject" | "warn";
2443
- threshold: number;
2444
- } | {
2445
- type: "pii-detector";
2446
- action: "reject" | "warn" | "scrub";
2447
- fields?: string[] | undefined;
2448
- } | {
2449
- function: string;
2450
- type: "custom";
2451
- module: string;
2452
- action: "reject" | "warn" | "log";
2453
- })[] | undefined;
2454
- } | undefined;
2455
- humanInTheLoop?: {
2456
- timeoutSeconds: number;
2457
- enabled: boolean;
2458
- timeoutAction: "reject" | "proceed" | "escalate";
2459
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
2460
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
2461
- webhookUrl?: string | undefined;
2462
- } | undefined;
2463
- evaluation?: {
2464
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
2465
- ciGate: boolean;
2466
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2467
- datasets?: {
2468
- name: string;
2469
- path: string;
2470
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2471
- }[] | undefined;
2472
- thresholds?: Record<string, number> | undefined;
2473
- } | undefined;
2474
- compliance?: {
2475
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
2476
- suppressions?: {
2477
- rule: string;
2478
- reason: string;
2479
- approvedBy?: string | undefined;
2480
- expires?: string | undefined;
2481
- }[] | undefined;
2482
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
2483
- } | undefined;
2484
- requires?: {
2485
- envVars?: string[] | undefined;
2486
- services?: {
2487
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
2488
- connection: string;
2489
- }[] | undefined;
2490
- minimumMemoryMB?: number | undefined;
2491
- nodeVersion?: string | undefined;
2492
- pythonVersion?: string | undefined;
2493
- } | undefined;
2494
- };
2495
- }, {
2496
- apiVersion: "agentspec.io/v1";
2497
- kind: "AgentSpec";
2498
- metadata: {
2499
- name: string;
2500
- version: string;
2501
- description: string;
2502
- tags?: string[] | undefined;
2503
- author?: string | undefined;
2504
- license?: string | undefined;
2505
- };
2506
- spec: {
2507
- model: {
2508
- provider: string;
2509
- id: string;
2510
- apiKey: string;
2511
- parameters?: {
2512
- temperature?: number | undefined;
2513
- maxTokens?: number | undefined;
2514
- topP?: number | undefined;
2515
- frequencyPenalty?: number | undefined;
2516
- presencePenalty?: number | undefined;
2517
- } | undefined;
2518
- fallback?: {
2519
- provider: string;
2520
- id: string;
2521
- apiKey: string;
2522
- triggerOn?: ("rate_limit" | "timeout" | "error_5xx" | "error_4xx")[] | undefined;
2523
- maxRetries?: number | undefined;
2524
- } | undefined;
2525
- costControls?: {
2526
- maxMonthlyUSD?: number | undefined;
2527
- alertAtUSD?: number | undefined;
2528
- } | undefined;
2529
- };
2530
- prompts: {
2531
- system: string;
2532
- fallback?: string | undefined;
2533
- hotReload?: boolean | undefined;
2534
- variables?: {
2535
- name: string;
2536
- value: string;
2537
- }[] | undefined;
2538
- };
2539
- mcp?: {
2540
- servers: {
2541
- name: string;
2542
- transport: "stdio" | "sse" | "http";
2543
- command?: string | undefined;
2544
- args?: string[] | undefined;
2545
- url?: string | undefined;
2546
- env?: Record<string, string> | undefined;
2547
- healthCheck?: {
2548
- timeoutSeconds?: number | undefined;
2549
- } | undefined;
2550
- }[];
2551
- } | undefined;
2552
- observability?: {
2553
- metrics?: {
2554
- backend: "datadog" | "opentelemetry" | "prometheus";
2555
- endpoint?: string | undefined;
2556
- serviceName?: string | undefined;
2557
- } | undefined;
2558
- tracing?: {
2559
- backend: "langsmith" | "langfuse" | "agentops" | "otel" | "honeycomb" | "datadog";
2560
- endpoint?: string | undefined;
2561
- publicKey?: string | undefined;
2562
- secretKey?: string | undefined;
2563
- sampleRate?: number | undefined;
2564
- } | undefined;
2565
- logging?: {
2566
- level?: "warn" | "debug" | "info" | "error" | undefined;
2567
- structured?: boolean | undefined;
2568
- redactFields?: string[] | undefined;
2569
- } | undefined;
2570
- } | undefined;
2571
- tools?: {
2572
- name: string;
2573
- description: string;
2574
- type: "function" | "mcp" | "builtin";
2575
- function?: string | undefined;
2576
- module?: string | undefined;
2577
- annotations?: {
2578
- readOnlyHint?: boolean | undefined;
2579
- destructiveHint?: boolean | undefined;
2580
- idempotentHint?: boolean | undefined;
2581
- openWorldHint?: boolean | undefined;
2582
- } | undefined;
2583
- }[] | undefined;
2584
- memory?: {
2585
- shortTerm?: {
2586
- backend: "in-memory" | "redis" | "sqlite";
2587
- maxTokens?: number | undefined;
2588
- maxTurns?: number | undefined;
2589
- ttlSeconds?: number | undefined;
2590
- connection?: string | undefined;
2591
- } | undefined;
2592
- longTerm?: {
2593
- backend: "sqlite" | "postgres" | "mongodb";
2594
- connectionString: string;
2595
- table?: string | undefined;
2596
- ttlDays?: number | undefined;
2597
- } | undefined;
2598
- vector?: {
2599
- backend: "pgvector" | "pinecone" | "weaviate" | "qdrant" | "chroma";
2600
- dimension: number;
2601
- apiKey?: string | undefined;
2602
- connectionString?: string | undefined;
2603
- topK?: number | undefined;
2604
- namespace?: string | undefined;
2605
- } | undefined;
2606
- hygiene?: {
2607
- piiScrubFields?: string[] | undefined;
2608
- auditLog?: boolean | undefined;
2609
- retentionPolicy?: string | undefined;
2610
- } | undefined;
2611
- } | undefined;
2612
- subagents?: {
2613
- name: string;
2614
- ref: {
2615
- agentspec: string;
2616
- } | {
2617
- a2a: {
2618
- url: string;
2619
- auth?: {
2620
- type: "bearer" | "apikey" | "none";
2621
- token?: string | undefined;
2622
- header?: string | undefined;
2623
- } | undefined;
2624
- };
2625
- };
2626
- invocation: "parallel" | "sequential" | "on-demand";
2627
- passContext?: boolean | undefined;
2628
- triggerKeywords?: string[] | undefined;
2629
- }[] | undefined;
2630
- api?: {
2631
- type: "mcp" | "rest" | "grpc" | "websocket";
2632
- auth?: {
2633
- type: "jwt" | "apikey" | "none" | "oauth2";
2634
- header?: string | undefined;
2635
- jwksUri?: string | undefined;
2636
- } | undefined;
2637
- streaming?: boolean | undefined;
2638
- port?: number | undefined;
2639
- pathPrefix?: string | undefined;
2640
- rateLimit?: {
2641
- requestsPerMinute?: number | undefined;
2642
- requestsPerHour?: number | undefined;
2643
- } | undefined;
2644
- healthEndpoint?: string | undefined;
2645
- metricsEndpoint?: string | undefined;
2646
- corsOrigins?: string[] | undefined;
2647
- chatEndpoint?: {
2648
- path?: string | undefined;
2649
- protocol?: "custom" | "openai-compatible" | undefined;
2650
- streaming?: boolean | undefined;
2651
- sessionMode?: "stateful" | "stateless" | undefined;
2652
- threadIdHeader?: string | undefined;
2653
- } | undefined;
2654
- } | undefined;
2655
- skills?: {
2656
- id: string;
2657
- version?: string | undefined;
2658
- }[] | undefined;
2659
- guardrails?: {
2660
- input?: ({
2661
- type: "topic-filter";
2662
- blockedTopics: string[];
2663
- action: "reject" | "warn" | "log";
2664
- message?: string | undefined;
2665
- } | {
2666
- type: "pii-detector";
2667
- action: "reject" | "warn" | "scrub";
2668
- fields?: string[] | undefined;
2669
- } | {
2670
- type: "prompt-injection";
2671
- action: "reject" | "warn";
2672
- sensitivity?: "low" | "medium" | "high" | undefined;
2673
- } | {
2674
- function: string;
2675
- type: "custom";
2676
- module: string;
2677
- action: "reject" | "warn" | "log";
2678
- })[] | undefined;
2679
- output?: ({
2680
- type: "hallucination-detector";
2681
- action: "reject" | "warn" | "retry";
2682
- threshold: number;
2683
- maxRetries?: number | undefined;
2684
- } | {
2685
- type: "toxicity-filter";
2686
- action: "reject" | "warn";
2687
- threshold: number;
2688
- } | {
2689
- type: "pii-detector";
2690
- action: "reject" | "warn" | "scrub";
2691
- fields?: string[] | undefined;
2692
- } | {
2693
- function: string;
2694
- type: "custom";
2695
- module: string;
2696
- action: "reject" | "warn" | "log";
2697
- })[] | undefined;
2698
- } | undefined;
2699
- humanInTheLoop?: {
2700
- timeoutSeconds?: number | undefined;
2701
- enabled?: boolean | undefined;
2702
- approvalRequired?: ("before-destructive-tool" | "before-external-call" | "on-low-confidence" | "on-high-cost" | "always")[] | undefined;
2703
- timeoutAction?: "reject" | "proceed" | "escalate" | undefined;
2704
- notifyVia?: ("email" | "slack" | "webhook" | "console")[] | undefined;
2705
- webhookUrl?: string | undefined;
2706
- } | undefined;
2707
- evaluation?: {
2708
- framework: "custom" | "deepeval" | "braintrust" | "langsmith" | "ragas";
2709
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2710
- datasets?: {
2711
- name: string;
2712
- path: string;
2713
- metrics?: ("custom" | "faithfulness" | "answer_relevancy" | "answer_similarity" | "hallucination" | "toxicity" | "context_precision" | "context_recall" | "bias")[] | undefined;
2714
- }[] | undefined;
2715
- thresholds?: Record<string, number> | undefined;
2716
- ciGate?: boolean | undefined;
2717
- } | undefined;
2718
- compliance?: {
2719
- packs?: ("owasp-llm-top10" | "memory-hygiene" | "model-resilience" | "evaluation-coverage" | "observability" | "metadata-quality")[] | undefined;
2720
- suppressions?: {
2721
- rule: string;
2722
- reason: string;
2723
- approvedBy?: string | undefined;
2724
- expires?: string | undefined;
2725
- }[] | undefined;
2726
- auditSchedule?: "daily" | "weekly" | "monthly" | "on-change" | undefined;
2727
- } | undefined;
2728
- requires?: {
2729
- envVars?: string[] | undefined;
2730
- services?: {
2731
- type: "redis" | "postgres" | "mongodb" | "mysql" | "elasticsearch";
2732
- connection: string;
2733
- }[] | undefined;
2734
- minimumMemoryMB?: number | undefined;
2735
- nodeVersion?: string | undefined;
2736
- pythonVersion?: string | undefined;
2737
- } | undefined;
2738
- };
2739
- }>;
839
+ }, z.core.$strip>>;
840
+ }, z.core.$strip>;
841
+ }, z.core.$strip>;
2740
842
  type AgentSpecManifest = z.infer<typeof ManifestSchema>;
2741
843
  type AgentSpecMetadata = z.infer<typeof MetadataSchema>;
2742
844
  type AgentSpecModel = z.infer<typeof ModelSchema>;
@@ -2758,6 +860,282 @@ type AgentSpecRequires = z.infer<typeof RequiresSchema>;
2758
860
  */
2759
861
  declare function exportJsonSchema(): object;
2760
862
 
863
+ declare const ContractSchema: z.ZodObject<{
864
+ version: z.ZodDefault<z.ZodLiteral<"1.0.0">>;
865
+ env: z.ZodPrefault<z.ZodObject<{
866
+ manifestPath: z.ZodDefault<z.ZodLiteral<"MANIFEST_PATH">>;
867
+ upstreamUrl: z.ZodDefault<z.ZodLiteral<"UPSTREAM_URL">>;
868
+ proxyPort: z.ZodDefault<z.ZodLiteral<"PROXY_PORT">>;
869
+ controlPlanePort: z.ZodDefault<z.ZodLiteral<"CONTROL_PLANE_PORT">>;
870
+ controlPlaneUrl: z.ZodDefault<z.ZodLiteral<"AGENTSPEC_CONTROL_PLANE_URL">>;
871
+ agentKey: z.ZodDefault<z.ZodLiteral<"AGENTSPEC_API_KEY">>;
872
+ trustPolicy: z.ZodDefault<z.ZodLiteral<"AGENTSPEC_TRUST_POLICY">>;
873
+ podspecFindings: z.ZodDefault<z.ZodLiteral<"AGENTSPEC_PODSPEC_FINDINGS">>;
874
+ gatewayKey: z.ZodDefault<z.ZodLiteral<"AGENTSPEC_GATEWAY_KEY">>;
875
+ agentHost: z.ZodDefault<z.ZodLiteral<"HOST">>;
876
+ agentPort: z.ZodDefault<z.ZodLiteral<"PORT">>;
877
+ azureResourceName: z.ZodDefault<z.ZodLiteral<"AZURE_OPENAI_RESOURCE_NAME">>;
878
+ }, z.core.$strict>>;
879
+ providerBaseUrlEnv: z.ZodPrefault<z.ZodObject<{
880
+ openai: z.ZodDefault<z.ZodLiteral<"OPENAI_BASE_URL">>;
881
+ anthropic: z.ZodDefault<z.ZodLiteral<"ANTHROPIC_BASE_URL">>;
882
+ }, z.core.$strict>>;
883
+ paths: z.ZodPrefault<z.ZodObject<{
884
+ manifestDir: z.ZodDefault<z.ZodLiteral<"/manifest">>;
885
+ manifestFile: z.ZodDefault<z.ZodLiteral<"/manifest/agent.yaml">>;
886
+ gatewayDatabase: z.ZodDefault<z.ZodLiteral<"/gateway-data/agentgateway.db">>;
887
+ gatewayConfigDir: z.ZodDefault<z.ZodLiteral<"/gateway">>;
888
+ gatewayConfigFile: z.ZodDefault<z.ZodLiteral<"/gateway/config.yaml">>;
889
+ sidecarEntrypoint: z.ZodDefault<z.ZodLiteral<"dist/index.js">>;
890
+ gatewayDataDir: z.ZodDefault<z.ZodLiteral<"/gateway-data">>;
891
+ }, z.core.$strict>>;
892
+ images: z.ZodPrefault<z.ZodObject<{
893
+ sidecar: z.ZodDefault<z.ZodLiteral<"ghcr.io/agents-oss/agentspec-sidecar:latest">>;
894
+ gateway: z.ZodDefault<z.ZodLiteral<"cr.agentgateway.dev/agentgateway:v1.6.0">>;
895
+ }, z.core.$strict>>;
896
+ ports: z.ZodPrefault<z.ZodObject<{
897
+ agentDefault: z.ZodDefault<z.ZodLiteral<8000>>;
898
+ agentBind: z.ZodDefault<z.ZodLiteral<18000>>;
899
+ proxy: z.ZodDefault<z.ZodLiteral<4000>>;
900
+ controlPlane: z.ZodDefault<z.ZodLiteral<4001>>;
901
+ gateway: z.ZodDefault<z.ZodLiteral<4002>>;
902
+ gatewayStats: z.ZodDefault<z.ZodLiteral<15020>>;
903
+ gatewayReadiness: z.ZodDefault<z.ZodLiteral<15021>>;
904
+ }, z.core.$strict>>;
905
+ sidecarPaths: z.ZodPrefault<z.ZodObject<{
906
+ healthReady: z.ZodDefault<z.ZodLiteral<"/health/ready">>;
907
+ gap: z.ZodDefault<z.ZodLiteral<"/gap">>;
908
+ explore: z.ZodDefault<z.ZodLiteral<"/explore">>;
909
+ proof: z.ZodDefault<z.ZodLiteral<"/proof">>;
910
+ traces: z.ZodDefault<z.ZodLiteral<"/v1/traces">>;
911
+ spans: z.ZodDefault<z.ZodLiteral<"/spans">>;
912
+ }, z.core.$strict>>;
913
+ agentPaths: z.ZodPrefault<z.ZodObject<{
914
+ health: z.ZodDefault<z.ZodLiteral<"/agentspec/health">>;
915
+ }, z.core.$strict>>;
916
+ controlPlanePaths: z.ZodPrefault<z.ZodObject<{
917
+ register: z.ZodDefault<z.ZodLiteral<"/api/v1/register">>;
918
+ heartbeat: z.ZodDefault<z.ZodLiteral<"/api/v1/heartbeat">>;
919
+ declaredAudit: z.ZodDefault<z.ZodLiteral<"/api/v1/agents/{name}/declared-audit">>;
920
+ sidecarPush: z.ZodDefault<z.ZodLiteral<"/api/v1/agents/{name}/sidecar-push">>;
921
+ evidence: z.ZodDefault<z.ZodLiteral<"/api/v1/agents/{name}/evidence">>;
922
+ }, z.core.$strict>>;
923
+ podPatch: z.ZodPrefault<z.ZodObject<{
924
+ sidecarContainer: z.ZodDefault<z.ZodLiteral<"agentspec-sidecar">>;
925
+ podspecFindingsAnnotation: z.ZodDefault<z.ZodLiteral<"agentspec.io/podspec-findings">>;
926
+ agentNameAnnotation: z.ZodDefault<z.ZodLiteral<"agentspec.io/agent-name">>;
927
+ manifestVolume: z.ZodDefault<z.ZodLiteral<"agentspec-manifest">>;
928
+ proxyPortName: z.ZodDefault<z.ZodLiteral<"proxy">>;
929
+ controlPortName: z.ZodDefault<z.ZodLiteral<"control">>;
930
+ gatewayContainer: z.ZodDefault<z.ZodLiteral<"agentspec-gateway">>;
931
+ gatewayConfigInitContainer: z.ZodDefault<z.ZodLiteral<"agentspec-gateway-config">>;
932
+ gatewayConfigCommand: z.ZodDefault<z.ZodLiteral<"gateway-config">>;
933
+ gatewayConfigVolume: z.ZodDefault<z.ZodLiteral<"agentspec-gateway-config">>;
934
+ gatewayDataVolume: z.ZodDefault<z.ZodLiteral<"agentspec-gateway-data">>;
935
+ agentTokenSecretSuffix: z.ZodDefault<z.ZodLiteral<"-agentspec-token">>;
936
+ agentTokenSecretKey: z.ZodDefault<z.ZodLiteral<"token">>;
937
+ loopback: z.ZodDefault<z.ZodLiteral<"127.0.0.1">>;
938
+ gatewayCpuRequest: z.ZodDefault<z.ZodLiteral<"25m">>;
939
+ gatewayMemoryRequest: z.ZodDefault<z.ZodLiteral<"32Mi">>;
940
+ gatewayMemoryLimit: z.ZodDefault<z.ZodLiteral<"128Mi">>;
941
+ }, z.core.$strict>>;
942
+ webhook: z.ZodPrefault<z.ZodObject<{
943
+ injectPath: z.ZodDefault<z.ZodLiteral<"/inject-sidecar">>;
944
+ namespaceLabel: z.ZodDefault<z.ZodLiteral<"agentspec.io/enabled">>;
945
+ }, z.core.$strict>>;
946
+ reasonCodes: z.ZodDefault<z.ZodArray<z.ZodString>>;
947
+ severityWeights: z.ZodPrefault<z.ZodObject<{
948
+ critical: z.ZodDefault<z.ZodLiteral<4>>;
949
+ high: z.ZodDefault<z.ZodLiteral<3>>;
950
+ medium: z.ZodDefault<z.ZodLiteral<2>>;
951
+ low: z.ZodDefault<z.ZodLiteral<1>>;
952
+ info: z.ZodDefault<z.ZodLiteral<0>>;
953
+ }, z.core.$strict>>;
954
+ gradeBands: z.ZodPrefault<z.ZodObject<{
955
+ A: z.ZodDefault<z.ZodLiteral<90>>;
956
+ B: z.ZodDefault<z.ZodLiteral<75>>;
957
+ C: z.ZodDefault<z.ZodLiteral<60>>;
958
+ D: z.ZodDefault<z.ZodLiteral<45>>;
959
+ }, z.core.$strict>>;
960
+ coverageThreshold: z.ZodDefault<z.ZodLiteral<60>>;
961
+ ruleEvidence: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
962
+ sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
963
+ class: z.ZodEnum<{
964
+ independent: "independent";
965
+ "evidence-point": "evidence-point";
966
+ offline: "offline";
967
+ declared: "declared";
968
+ }>;
969
+ collector: z.ZodEnum<{
970
+ "gateway-config": "gateway-config";
971
+ "gateway-traffic": "gateway-traffic";
972
+ "sidecar-probe": "sidecar-probe";
973
+ "sidecar-forwarder": "sidecar-forwarder";
974
+ "sidecar-eval": "sidecar-eval";
975
+ "operator-webhook": "operator-webhook";
976
+ "operator-logs": "operator-logs";
977
+ sdk: "sdk";
978
+ lock: "lock";
979
+ manifest: "manifest";
980
+ }>;
981
+ point: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
982
+ guardrail: "guardrail";
983
+ tool: "tool";
984
+ mcpClient: "mcpClient";
985
+ memoryWrite: "memoryWrite";
986
+ vectorStore: "vectorStore";
987
+ logging: "logging";
988
+ }>>>;
989
+ proves: z.ZodEnum<{
990
+ declared: "declared";
991
+ configured: "configured";
992
+ enforced: "enforced";
993
+ observed: "observed";
994
+ "ran-where-wired": "ran-where-wired";
995
+ "every-path": "every-path";
996
+ effective: "effective";
997
+ }>;
998
+ wiredBy: z.ZodEnum<{
999
+ none: "none";
1000
+ "operator-render": "operator-render";
1001
+ "agent-code": "agent-code";
1002
+ "user-schedule": "user-schedule";
1003
+ "opt-in": "opt-in";
1004
+ }>;
1005
+ modes: z.ZodArray<z.ZodEnum<{
1006
+ standalone: "standalone";
1007
+ operator: "operator";
1008
+ }>>;
1009
+ status: z.ZodEnum<{
1010
+ built: "built";
1011
+ partial: "partial";
1012
+ planned: "planned";
1013
+ open: "open";
1014
+ }>;
1015
+ when: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1016
+ crossCheck: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1017
+ "gateway-config": "gateway-config";
1018
+ "gateway-traffic": "gateway-traffic";
1019
+ "sidecar-probe": "sidecar-probe";
1020
+ "sidecar-forwarder": "sidecar-forwarder";
1021
+ "sidecar-eval": "sidecar-eval";
1022
+ "operator-webhook": "operator-webhook";
1023
+ "operator-logs": "operator-logs";
1024
+ sdk: "sdk";
1025
+ lock: "lock";
1026
+ manifest: "manifest";
1027
+ }>>>;
1028
+ question: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1029
+ }, z.core.$strict>>>;
1030
+ derivedFrom: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
1031
+ notProven: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1032
+ }, z.core.$strict>>>;
1033
+ evidencePoints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
1034
+ evidencePointRecordLimit: z.ZodDefault<z.ZodLiteral<5>>;
1035
+ heartbeatMaxBytes: z.ZodDefault<z.ZodLiteral<number>>;
1036
+ otlp: z.ZodPrefault<z.ZodObject<{
1037
+ resourceAgentName: z.ZodDefault<z.ZodLiteral<"agentspec.agent.name">>;
1038
+ resourceManifestSha256: z.ZodDefault<z.ZodLiteral<"agentspec.manifest.sha256">>;
1039
+ endpointEnv: z.ZodDefault<z.ZodLiteral<"OTEL_EXPORTER_OTLP_ENDPOINT">>;
1040
+ resourceServiceName: z.ZodDefault<z.ZodLiteral<"service.name">>;
1041
+ gatewayServiceName: z.ZodDefault<z.ZodLiteral<"agentgateway">>;
1042
+ }, z.core.$strict>>;
1043
+ }, z.core.$strict>;
1044
+ type Contract = z.infer<typeof ContractSchema>;
1045
+ declare const CONTRACT: Contract;
1046
+
1047
+ /**
1048
+ * Rule evidence registry (ADR-0040): for every audit rule, the sources that can prove it, their
1049
+ * evidence class (ADR-0039), who wires them, and what a pass does not prove. The grader, heartbeat,
1050
+ * `agentspec lock` prompt and docs derive from it. Generated to Pydantic by `pnpm contract:generate`
1051
+ * through `ContractSchema.ruleEvidence`; build state per source is tracked on GitHub (ADR-0036).
1052
+ */
1053
+ declare const EvidenceClass: z.ZodEnum<{
1054
+ independent: "independent";
1055
+ "evidence-point": "evidence-point";
1056
+ offline: "offline";
1057
+ declared: "declared";
1058
+ }>;
1059
+ declare const RuleEvidenceEntry: z.ZodObject<{
1060
+ sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
1061
+ class: z.ZodEnum<{
1062
+ independent: "independent";
1063
+ "evidence-point": "evidence-point";
1064
+ offline: "offline";
1065
+ declared: "declared";
1066
+ }>;
1067
+ collector: z.ZodEnum<{
1068
+ "gateway-config": "gateway-config";
1069
+ "gateway-traffic": "gateway-traffic";
1070
+ "sidecar-probe": "sidecar-probe";
1071
+ "sidecar-forwarder": "sidecar-forwarder";
1072
+ "sidecar-eval": "sidecar-eval";
1073
+ "operator-webhook": "operator-webhook";
1074
+ "operator-logs": "operator-logs";
1075
+ sdk: "sdk";
1076
+ lock: "lock";
1077
+ manifest: "manifest";
1078
+ }>;
1079
+ point: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1080
+ guardrail: "guardrail";
1081
+ tool: "tool";
1082
+ mcpClient: "mcpClient";
1083
+ memoryWrite: "memoryWrite";
1084
+ vectorStore: "vectorStore";
1085
+ logging: "logging";
1086
+ }>>>;
1087
+ proves: z.ZodEnum<{
1088
+ declared: "declared";
1089
+ configured: "configured";
1090
+ enforced: "enforced";
1091
+ observed: "observed";
1092
+ "ran-where-wired": "ran-where-wired";
1093
+ "every-path": "every-path";
1094
+ effective: "effective";
1095
+ }>;
1096
+ wiredBy: z.ZodEnum<{
1097
+ none: "none";
1098
+ "operator-render": "operator-render";
1099
+ "agent-code": "agent-code";
1100
+ "user-schedule": "user-schedule";
1101
+ "opt-in": "opt-in";
1102
+ }>;
1103
+ modes: z.ZodArray<z.ZodEnum<{
1104
+ standalone: "standalone";
1105
+ operator: "operator";
1106
+ }>>;
1107
+ status: z.ZodEnum<{
1108
+ built: "built";
1109
+ partial: "partial";
1110
+ planned: "planned";
1111
+ open: "open";
1112
+ }>;
1113
+ when: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1114
+ crossCheck: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1115
+ "gateway-config": "gateway-config";
1116
+ "gateway-traffic": "gateway-traffic";
1117
+ "sidecar-probe": "sidecar-probe";
1118
+ "sidecar-forwarder": "sidecar-forwarder";
1119
+ "sidecar-eval": "sidecar-eval";
1120
+ "operator-webhook": "operator-webhook";
1121
+ "operator-logs": "operator-logs";
1122
+ sdk: "sdk";
1123
+ lock: "lock";
1124
+ manifest: "manifest";
1125
+ }>>>;
1126
+ question: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1127
+ }, z.core.$strict>>>;
1128
+ derivedFrom: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
1129
+ notProven: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1130
+ }, z.core.$strict>;
1131
+ /** The evidence classes of ADR-0039. */
1132
+ type EvidenceClassName = z.infer<typeof EvidenceClass>;
1133
+ /** Rule id → entry. Parsed once, so an entry that breaks the shape fails at import. */
1134
+ declare const RULE_EVIDENCE: Record<string, z.infer<typeof RuleEvidenceEntry>>;
1135
+ type Registry = Readonly<Record<string, z.infer<typeof RuleEvidenceEntry>>>;
1136
+ /** Evidence classes that can prove a rule: its own sources', or those of the rules it derives from. */
1137
+ declare function ruleClasses(ruleId: string, registry?: Registry): EvidenceClassName[];
1138
+
2761
1139
  type SecretBackend = 'env' | 'vault' | 'aws' | 'gcp' | 'azure';
2762
1140
  interface ResolverOptions {
2763
1141
  /** Directory where agent.yaml lives — used to resolve $file: paths */
@@ -2771,7 +1149,7 @@ type RefType = 'env' | 'secret' | 'file' | 'func' | 'literal';
2771
1149
  declare function detectRefType(value: string): RefType;
2772
1150
  /**
2773
1151
  * Resolve a single reference value.
2774
- * Returns the resolved string or null if optional and missing.
1152
+ * Returns the resolved string, or '' for a missing $env var/$file when `optional` is set.
2775
1153
  */
2776
1154
  declare function resolveRef(value: string, opts: ResolverOptions, { optional }?: {
2777
1155
  optional?: boolean;
@@ -2813,6 +1191,8 @@ interface ParsedManifest {
2813
1191
  filePath: string;
2814
1192
  /** Directory containing agent.yaml — base for $file: resolution */
2815
1193
  baseDir: string;
1194
+ /** Deprecation warnings found in the manifest as written (validate prints them) */
1195
+ warnings: string[];
2816
1196
  /** Raw YAML string */
2817
1197
  raw: string;
2818
1198
  }
@@ -2849,11 +1229,11 @@ declare function migrateManifest(raw: Record<string, unknown>): {
2849
1229
  declare function detectVersion(raw: Record<string, unknown>): string;
2850
1230
  declare function isLatestVersion(raw: Record<string, unknown>): boolean;
2851
1231
 
2852
- type CheckStatus = 'pass' | 'fail' | 'warn' | 'skip';
1232
+ type CheckStatus = 'pass' | 'fail' | 'warn' | 'skip' | 'not_verifiable';
2853
1233
  type CheckSeverity = 'error' | 'warning' | 'info';
2854
1234
  interface HealthCheck {
2855
1235
  id: string;
2856
- category: 'env' | 'file' | 'model' | 'model-fallback' | 'mcp' | 'memory' | 'subagent' | 'eval' | 'service' | 'tool';
1236
+ category: 'env' | 'file' | 'model' | 'mcp' | 'memory' | 'subagent' | 'eval' | 'service' | 'tool';
2857
1237
  status: CheckStatus;
2858
1238
  severity: CheckSeverity;
2859
1239
  latencyMs?: number;
@@ -2874,6 +1254,8 @@ interface HealthReport {
2874
1254
  checks: HealthCheck[];
2875
1255
  }
2876
1256
  interface HealthCheckOptions {
1257
+ /** Run the env var and secret backend checks, which read this process's environment. Default: true */
1258
+ checkEnv?: boolean;
2877
1259
  /** Run model API reachability checks (makes HTTP requests). Default: true */
2878
1260
  checkModel?: boolean;
2879
1261
  /** Run MCP server checks. Default: true */
@@ -2887,13 +1269,63 @@ interface HealthCheckOptions {
2887
1269
  /** Raw parsed YAML object (for $env/$file ref collection) */
2888
1270
  rawManifest?: unknown;
2889
1271
  }
1272
+ declare function computeHealthStatus(checks: HealthCheck[]): {
1273
+ status: HealthStatus;
1274
+ summary: {
1275
+ passed: number;
1276
+ failed: number;
1277
+ warnings: number;
1278
+ skipped: number;
1279
+ };
1280
+ };
2890
1281
  declare function runHealthCheck(manifest: AgentSpecManifest, opts?: HealthCheckOptions): Promise<HealthReport>;
2891
1282
 
2892
- type RuleSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
1283
+ type Evidence = z.infer<typeof EvidenceRecord>;
1284
+ type Severity$1 = z.infer<typeof SeveritySchema>;
1285
+ type Reason = z.infer<typeof EvidenceReason>;
1286
+ type PointAggregate = z.infer<typeof EvidencePointAggregate>;
1287
+ type GraderPolicy = z.infer<typeof TrustPolicy>;
1288
+ interface GraderRule {
1289
+ id: string;
1290
+ severity: Severity$1;
1291
+ }
1292
+ type Grade = 'A' | 'B' | 'C' | 'D' | 'F';
1293
+ interface UnverifiedRule {
1294
+ ruleId: string;
1295
+ severity: Severity$1;
1296
+ reason: Reason;
1297
+ }
1298
+ interface GradeResult {
1299
+ /** Severity-weighted pass rate over rules with fresh admitted evidence, 0-100. */
1300
+ verified: number;
1301
+ /** Severity-weighted share of applicable rules with fresh admitted evidence, 0-100. */
1302
+ coverage: number;
1303
+ /** Share of covered weight whose admitted evidence is all `independent`, 0-100. */
1304
+ independentShare: number;
1305
+ grade: Grade | 'Not graded';
1306
+ unverified: UnverifiedRule[];
1307
+ }
1308
+ /** Letter grade for a 0-100 score, from the contract's grade bands. */
1309
+ declare function scoreToGrade(score: number): Grade;
1310
+ /**
1311
+ * The verified score (ADR-0007, spec #145 § Grader). Pure: records and rules in, display numbers out.
1312
+ * Coverage and verified are rounded before the threshold and bands apply, so the grade matches the printed numbers.
1313
+ * Only records carrying a `ruleId` of an applicable rule are graded; `now` is an RFC 3339 timestamp.
1314
+ */
1315
+ declare function grade(records: Evidence[], applicableRules: GraderRule[], policy: GraderPolicy, now: string, points?: PointAggregate[]): GradeResult;
1316
+ /** `<grade> - <verified>% verified (<independent>% independent) - coverage <coverage>%`, or `Not graded (coverage x%)`. */
1317
+ declare function formatVerified(result: GradeResult): string;
1318
+
1319
+ /** MODEL-02's predicate, shared with the sidecar's trace records so they cannot disagree on what pinned means. */
1320
+ declare const isLatestModelId: (id: string) => boolean;
1321
+
1322
+ /** Highest temperature META-02 accepts; the sidecar grades gateway traffic against the same bound. */
1323
+ declare const MAX_PRODUCTION_TEMPERATURE = 1.5;
1324
+
1325
+ type RuleSeverity = z.infer<typeof SeveritySchema>;
2893
1326
  /** Canonical severity type shared across packages. Alias of RuleSeverity. */
2894
1327
  type Severity = RuleSeverity;
2895
1328
  type CompliancePack = 'owasp-llm-top10' | 'model-resilience' | 'memory-hygiene' | 'evaluation-coverage' | 'observability' | 'metadata-quality';
2896
- type EvidenceLevel = 'declarative' | 'probed' | 'behavioral' | 'external';
2897
1329
  interface RuleResult {
2898
1330
  pass: boolean;
2899
1331
  message?: string;
@@ -2907,15 +1339,11 @@ interface AuditRule {
2907
1339
  title: string;
2908
1340
  description: string;
2909
1341
  severity: RuleSeverity;
2910
- /** What kind of evidence supports this rule's verdict */
2911
- evidenceLevel: EvidenceLevel;
2912
- /**
2913
- * Human-readable name of the external tool that can prove this rule.
2914
- * Defined for 'external' evidence level rules; optional on 'probed'.
2915
- */
2916
- proofTool?: string;
2917
- /** URL to integration guide or documentation for the proof tool */
2918
- proofToolUrl?: string;
1342
+ /** Set when the evidence that can verify this rule comes from a later phase; the unverified list names the reason and phase. */
1343
+ awaitsEvidence?: {
1344
+ code: string;
1345
+ phase: number;
1346
+ };
2919
1347
  check(manifest: AgentSpecManifest): RuleResult;
2920
1348
  }
2921
1349
  interface AuditViolation {
@@ -2926,38 +1354,22 @@ interface AuditViolation {
2926
1354
  path?: string;
2927
1355
  recommendation?: string;
2928
1356
  references?: string[];
2929
- /** What kind of evidence supports this violation */
2930
- evidenceLevel: EvidenceLevel;
2931
- /** Proof tool recommendation (for 'external' rules) */
1357
+ /** The evidence classes that can prove this rule, from the rule evidence registry */
1358
+ evidenceClasses: EvidenceClassName[];
1359
+ /** The `→ Prove:` hint, from `proofHint()` */
2932
1360
  proofTool?: string;
2933
- /** Proof tool URL (for 'external' rules) */
1361
+ /** Where to read that evidence, from `proofHint()` */
2934
1362
  proofToolUrl?: string;
2935
1363
  }
2936
- interface EvidenceBreakdown {
2937
- declarative: {
2938
- passed: number;
2939
- total: number;
2940
- };
2941
- probed: {
2942
- passed: number;
2943
- total: number;
2944
- };
2945
- behavioral: {
2946
- passed: number;
2947
- total: number;
2948
- };
2949
- external: {
2950
- passed: number;
2951
- total: number;
2952
- };
2953
- }
2954
- /** A proof record submitted by an external tool to the sidecar's /proof endpoint */
2955
- interface ProofRecord {
2956
- ruleId: string;
2957
- verifiedAt: string;
2958
- verifiedBy: string;
2959
- method: string;
2960
- expiresAt?: string;
1364
+ /** Passed and total rules per evidence class (ADR-0039); a rule with sources in two classes counts in both. */
1365
+ type EvidenceBreakdown = Record<EvidenceClassName, {
1366
+ passed: number;
1367
+ total: number;
1368
+ }>;
1369
+ /** What can prove a rule and what a pass leaves unproven, read from the rule evidence registry (ADR-0040). */
1370
+ interface RuleEvidenceSummary {
1371
+ classes: EvidenceClassName[];
1372
+ notProven: string | null;
2961
1373
  }
2962
1374
  interface AuditReport {
2963
1375
  agentName: string;
@@ -2974,15 +1386,12 @@ interface AuditReport {
2974
1386
  total: number;
2975
1387
  }>;
2976
1388
  evidenceBreakdown: EvidenceBreakdown;
2977
- /**
2978
- * Score based only on proved rules (probed + behavioral + external with proof records).
2979
- * Only present when proofRecords are provided to runAudit (e.g. via --url flag).
2980
- */
2981
- provedScore?: number;
2982
- /** Grade corresponding to provedScore */
2983
- provedGrade?: 'A' | 'B' | 'C' | 'D' | 'F';
2984
- /** Number of 'external' rules that pass declaratively but lack a proof record */
2985
- pendingProofCount?: number;
1389
+ /** The verified score: what evidence admitted by the trust policy proves (ADR-0007). `overallScore` is the declared score. */
1390
+ verified: GradeResult;
1391
+ /** The rules the verified score is graded over (suppressed rules left out); the control plane grades heartbeat evidence against them. */
1392
+ applicableRules: GraderRule[];
1393
+ /** Per rule that ran: the evidence classes that can prove it and its `notProven` text. */
1394
+ ruleEvidence: Record<string, RuleEvidenceSummary>;
2986
1395
  }
2987
1396
  interface SuppressionRecord {
2988
1397
  ruleId: string;
@@ -2995,19 +1404,24 @@ interface AuditOptions {
2995
1404
  packs?: CompliancePack[];
2996
1405
  /** Include rules from the manifest's compliance.packs. Default: true */
2997
1406
  useManifestPacks?: boolean;
2998
- /**
2999
- * Proof records fetched from the sidecar's GET /proof endpoint.
3000
- * When provided, provedScore and pendingProofCount are computed.
3001
- */
3002
- proofRecords?: ProofRecord[];
1407
+ /** Evidence records graded into `verified`. Default: none. */
1408
+ records?: z.infer<typeof EvidenceRecord>[];
1409
+ /** Trust policy for `verified`. Default: standard. Never set from agent.yaml. */
1410
+ trust?: GraderPolicy;
1411
+ /** Evidence point aggregates from the heartbeat; a `not_wired` point leaves its rule unproven. Default: none. */
1412
+ evidencePoints?: z.infer<typeof EvidencePointAggregate>[];
3003
1413
  }
3004
1414
  /** Set of all valid audit rule IDs — single source of truth for validation. */
3005
1415
  declare const AUDIT_RULE_IDS: ReadonlySet<string>;
3006
- /** Type guard: returns true if `r` is a structurally valid ProofRecord. */
3007
- declare function isProofRecord(r: unknown): r is ProofRecord;
3008
- declare function scoreToGrade(score: number): 'A' | 'B' | 'C' | 'D' | 'F';
1416
+ /** Compliance packs that own at least one rule, derived from the rule registry. */
1417
+ declare const COMPLIANCE_PACKS: readonly CompliancePack[];
3009
1418
  declare function runAudit(manifest: AgentSpecManifest, opts?: AuditOptions): AuditReport;
3010
1419
 
1420
+ /** sha256 of the manifest as written in agent.yaml (`$ref`s unresolved) as canonical JSON, UTF-8. */
1421
+ declare function canonicalManifestSha256(manifest: unknown): string;
1422
+ /** The hash `agentspec register` sends, from the text of agent.yaml: parsed without schema defaults or resolved references. */
1423
+ declare function declaredManifestSha256(raw: string): string;
1424
+
3011
1425
  interface GeneratedAgent {
3012
1426
  framework: string;
3013
1427
  files: Record<string, string>;
@@ -3045,12 +1459,15 @@ declare function generateAdapter(manifest: AgentSpecManifest, framework: string,
3045
1459
  *
3046
1460
  * Two env vars are enough to activate push mode:
3047
1461
  * AGENTSPEC_URL=https://control-plane.agentspec.io
3048
- * AGENTSPEC_KEY=<key from agentspec register>
1462
+ * AGENTSPEC_KEY=<agent token from POST /api/v1/register>
3049
1463
  */
3050
1464
  interface PushModeOptions {
3051
- /** Control plane base URL, e.g. https://control-plane.agentspec.io */
3052
- controlPlaneUrl: string;
3053
- /** Bearer token obtained from `agentspec register` or POST /api/v1/register */
1465
+ /**
1466
+ * Control plane base URL, e.g. https://control-plane.agentspec.io.
1467
+ * Defaults to AGENTSPEC_CONTROL_PLANE_URL (injected by the operator webhook).
1468
+ */
1469
+ controlPlaneUrl?: string;
1470
+ /** Bearer token returned by POST /api/v1/register */
3054
1471
  apiKey: string;
3055
1472
  /** Heartbeat interval in seconds. Default: 30 */
3056
1473
  intervalSeconds?: number;
@@ -3084,10 +1501,16 @@ declare class UsageLedger {
3084
1501
  * Return a frozen snapshot of the current usage window.
3085
1502
  *
3086
1503
  * @param reset - When true (default), clears all counters and starts a new
3087
- * window. Use reset=true in the heartbeat push so each window is shipped
3088
- * exactly once. Use reset=false for inspection without draining.
1504
+ * window. Use reset=false for inspection without draining; the heartbeat
1505
+ * push takes a reset=false snapshot and calls subtract() with it.
3089
1506
  */
3090
1507
  snapshot(reset?: boolean): UsageSnapshot;
1508
+ /**
1509
+ * Remove a shipped snapshot from the ledger; a new window starts, because the control plane dedupes heartbeats on windowStartedAt.
1510
+ * Usage recorded after the snapshot was taken stays, so every token is
1511
+ * shipped exactly once even when a call finishes while a heartbeat is in flight.
1512
+ */
1513
+ subtract(shipped: UsageSnapshot): void;
3091
1514
  }
3092
1515
 
3093
1516
  /**
@@ -3098,13 +1521,16 @@ declare class UsageLedger {
3098
1521
  * configurable TTL and exposes it via a standard HTTP handler mounted at
3099
1522
  * GET /agentspec/health.
3100
1523
  *
1524
+ * Pass `loadManifest().baseDir` (and, if you loaded with `resolve: true`, the unresolved
1525
+ * manifest as `rawManifest`) to enable the file, eval dataset and local subagent checks.
1526
+ *
3101
1527
  * Usage (Fastify):
3102
- * const reporter = new AgentSpecReporter(manifest, { refreshIntervalMs: 30_000 })
1528
+ * const reporter = new AgentSpecReporter(manifest, { refreshIntervalMs: 30_000, baseDir })
3103
1529
  * reporter.start()
3104
1530
  * await app.register(agentSpecFastifyPlugin(reporter))
3105
1531
  *
3106
1532
  * Usage (Express):
3107
- * const reporter = new AgentSpecReporter(manifest)
1533
+ * const reporter = new AgentSpecReporter(manifest, { baseDir })
3108
1534
  * reporter.start()
3109
1535
  * app.use('/agentspec', agentSpecExpressRouter(reporter))
3110
1536
  */
@@ -3121,6 +1547,18 @@ interface ReporterOptions {
3121
1547
  * Default: 60_000 ms (60 seconds)
3122
1548
  */
3123
1549
  staleAfterMs?: number;
1550
+ /**
1551
+ * Directory of the agent.yaml (`loadManifest().baseDir`). Without it the
1552
+ * `file`, `subagent` (local refs) and `eval:dataset:*` checks are not run.
1553
+ */
1554
+ baseDir?: string;
1555
+ /**
1556
+ * The parsed but unresolved manifest object, so `$env:` / `$file:` refs can still be collected.
1557
+ * Only needed when `manifest` was loaded with `resolve: true`; `loadManifest(file).manifest`
1558
+ * (the default, `resolve: false`) is already unresolved. Also pass it so evidence records carry the hash of the manifest as
1559
+ * written, not of the loaded one (schema defaults change the hash). Not `loadManifest().raw`, which is the YAML string.
1560
+ */
1561
+ rawManifest?: Record<string, unknown>;
3124
1562
  }
3125
1563
  declare class AgentSpecReporter {
3126
1564
  private readonly manifest;
@@ -3130,24 +1568,20 @@ declare class AgentSpecReporter {
3130
1568
  private _pushTimer;
3131
1569
  private readonly refreshIntervalMs;
3132
1570
  private readonly staleAfterMs;
3133
- private refreshing;
1571
+ private inflight;
1572
+ /** True while a heartbeat POST is in flight; a tick that finds it set sends nothing. */
1573
+ private heartbeatInFlight;
3134
1574
  private stopped;
3135
- private readonly registeredTools;
3136
1575
  /** In-process token usage accumulator. */
3137
1576
  readonly usage: UsageLedger;
1577
+ /** Evidence points the agent's code wires (`guardrail(...)` reports here); each heartbeat sends the window's aggregates. */
1578
+ readonly evidence: EvidencePoints;
3138
1579
  constructor(manifest: AgentSpecManifest, opts?: ReporterOptions);
3139
1580
  /**
3140
- * Register a tool handler by name.
3141
- * Only registered tools report status: 'pass' in the live health check.
3142
- * Declared tools that are not registered report status: 'fail'.
3143
- *
3144
- * Call this once per tool after wiring up your tool handlers:
3145
- * reporter.registerTool('search-arxiv', handler)
3146
- *
3147
- * The handler argument is accepted but not called — it is retained solely so
3148
- * callers can pass the real function object for documentation purposes.
1581
+ * @deprecated No-op, kept so existing callers compile. Registering a handler proves nothing about
1582
+ * which tools the agent calls, so the health report no longer carries `tool:<name>` checks (ADR-0017).
3149
1583
  */
3150
- registerTool(name: string, _handler?: unknown): void;
1584
+ registerTool(_name: string, _handler?: unknown): void;
3151
1585
  /**
3152
1586
  * Start background refresh. Call once during app startup.
3153
1587
  * The first refresh runs immediately (non-blocking).
@@ -3188,7 +1622,9 @@ declare class AgentSpecReporter {
3188
1622
  stopPushMode(): void;
3189
1623
  /** Returns true if heartbeats are currently being sent. */
3190
1624
  isPushModeActive(): boolean;
1625
+ /** Runs one refresh; concurrent callers share the in-flight promise so they all see a populated cache. */
3191
1626
  private refresh;
1627
+ private runRefresh;
3192
1628
  }
3193
1629
 
3194
1630
  /**
@@ -3200,7 +1636,7 @@ declare class AgentSpecReporter {
3200
1636
  * import { AgentSpecReporter } from '@agentspec/sdk'
3201
1637
  * import { agentSpecFastifyPlugin } from '@agentspec/sdk/agent/adapters/fastify'
3202
1638
  *
3203
- * const reporter = new AgentSpecReporter(manifest, { refreshIntervalMs: 30_000 })
1639
+ * const reporter = new AgentSpecReporter(manifest, { refreshIntervalMs: 30_000, baseDir })
3204
1640
  * reporter.start()
3205
1641
  * await app.register(agentSpecFastifyPlugin(reporter))
3206
1642
  */
@@ -3231,7 +1667,7 @@ declare function agentSpecFastifyPlugin(reporter: AgentSpecReporter): FastifyPlu
3231
1667
  * import { AgentSpecReporter } from '@agentspec/sdk'
3232
1668
  * import { agentSpecExpressRouter } from '@agentspec/sdk/agent/adapters/express'
3233
1669
  *
3234
- * const reporter = new AgentSpecReporter(manifest)
1670
+ * const reporter = new AgentSpecReporter(manifest, { baseDir })
3235
1671
  * reporter.start()
3236
1672
  * app.use('/agentspec', agentSpecExpressRouter(reporter))
3237
1673
  *
@@ -3289,4 +1725,45 @@ interface ServiceSpec {
3289
1725
  */
3290
1726
  declare function runServiceChecks(services: ServiceSpec[]): Promise<HealthCheck[]>;
3291
1727
 
3292
- export { AUDIT_RULE_IDS, type AgentSpecChatEndpoint, type AgentSpecCompliance, type AgentSpecEvaluation, type AgentSpecGuardrails, type AgentSpecHumanInTheLoop, type AgentSpecManifest, type AgentSpecMcpServer, type AgentSpecMemory, type AgentSpecMetadata, type AgentSpecModel, type AgentSpecObservability, type AgentSpecPrompts, AgentSpecReporter, type AgentSpecRequires, type AgentSpecTool, type AuditOptions, type AuditReport, type AuditRule, type AuditViolation, type CheckSeverity, type CheckStatus, type CompliancePack, type EvidenceBreakdown, type EvidenceLevel, type FrameworkAdapter, type GeneratedAgent, type HealthCheck, type HealthCheckOptions, type HealthReport, type HealthStatus, LATEST_API_VERSION, type LoadOptions, ManifestSchema, type Migration, type ModelUsageEntry, type ParsedManifest, type ProofRecord, type PushModeOptions, type RefType, type ReporterOptions, type ResolverOptions, type RuleResult, type RuleSeverity, type SecretBackend, type Severity, type SuppressionRecord, UsageLedger, type UsageSnapshot, agentSpecExpressRouter, agentSpecFastifyPlugin, collectEnvRefs, collectFileRefs, detectRefType, detectVersion, exportJsonSchema, generateAdapter, getAdapter, isLatestVersion, isProofRecord, listAdapters, loadManifest, migrateManifest, registerAdapter, resolveRef, resolveRefs, runAudit, runHealthCheck, runServiceChecks, scoreToGrade, tryLoadManifest };
1728
+ /**
1729
+ * Lowercase slug: `a-z`, `0-9`, hyphens only. Mirrors the CLI scan builder's slugify
1730
+ * so names produced by `scan --profile claude-code` match what the claude-plugin compares.
1731
+ *
1732
+ * "mcp__github__create_issue" → "mcp-github-create-issue"
1733
+ */
1734
+ declare function slugify(s: string): string;
1735
+ /**
1736
+ * The health-check id of a declared tool: `tool:` plus the slug of its name. Every producer
1737
+ * (claude-plugin bridge) and consumer (sidecar `/explore`) of tool checks goes through this.
1738
+ * The id is always `tool:` + `slugify(name)`; callers that key per-tool state by the bare slug
1739
+ * (the plugin's observations) use `slugify` and rely on that.
1740
+ */
1741
+ declare function toolCheckId(toolName: string): string;
1742
+
1743
+ /**
1744
+ * Gateway config renderer (ADR-0025)
1745
+ *
1746
+ * Renders the agentgateway v1.6.0 config from an agent.yaml manifest. Shared by the
1747
+ * sidecar's `gateway-config` entrypoint (the pod's init container) and the
1748
+ * `agentspec gateway-config` CLI preview.
1749
+ * Output is deterministic: the same manifest always yields the same bytes.
1750
+ *
1751
+ * No secret is written into the config. Provider keys, the agent's virtual key and the
1752
+ * Azure resource name are `$VAR` references that agentgateway expands from the gateway
1753
+ * container's environment at load time.
1754
+ */
1755
+
1756
+ /** Env var the `env` secret backend resolves `$secret:<name>` from (mirrors the loader's resolver). */
1757
+ declare function secretEnvName(name: string): string;
1758
+ /**
1759
+ * Env vars the gateway container must hold for this manifest: each model's provider key,
1760
+ * the env var of a `$env:` baseUrl, plus the Azure resource name when an Azure model without a
1761
+ * baseUrl is configured. Sorted, deduplicated.
1762
+ */
1763
+ declare function gatewayEnvNames(manifest: AgentSpecManifest): string[];
1764
+ declare function renderGatewayConfig(manifest: AgentSpecManifest): string;
1765
+ /** Zod issues arrive as a JSON-encoded message; print each as `path: message`. */
1766
+ declare function describeManifestError(err: unknown): string;
1767
+
1768
+ export { AUDIT_RULE_IDS, AgentSpecReporter, COMPLIANCE_PACKS, CONTRACT, ContractSchema, EvidenceReason, EvidenceRecord, LATEST_API_VERSION, MAX_PRODUCTION_TEMPERATURE, ManifestSchema, RULE_EVIDENCE, RuleEvidenceEntry, SeveritySchema, TrustPolicy, UsageLedger, agentSpecExpressRouter, agentSpecFastifyPlugin, canonicalManifestSha256, collectEnvRefs, collectFileRefs, computeHealthStatus, declaredManifestSha256, describeManifestError, detectRefType, detectVersion, exportJsonSchema, formatVerified, gatewayEnvNames, generateAdapter, getAdapter, grade, isLatestModelId, isLatestVersion, listAdapters, loadManifest, migrateManifest, registerAdapter, renderGatewayConfig, resolveRef, resolveRefs, ruleClasses, runAudit, runHealthCheck, runServiceChecks, scoreToGrade, secretEnvName, slugify, toolCheckId, tryLoadManifest };
1769
+ export type { AgentSpecChatEndpoint, AgentSpecCompliance, AgentSpecEvaluation, AgentSpecGuardrails, AgentSpecHumanInTheLoop, AgentSpecManifest, AgentSpecMcpServer, AgentSpecMemory, AgentSpecMetadata, AgentSpecModel, AgentSpecObservability, AgentSpecPrompts, AgentSpecRequires, AgentSpecTool, AuditOptions, AuditReport, AuditRule, AuditViolation, CheckSeverity, CheckStatus, CompliancePack, Contract, EvidenceBreakdown, EvidenceClassName, FrameworkAdapter, GeneratedAgent, Grade, GradeResult, GraderPolicy, GraderRule, HealthCheck, HealthCheckOptions, HealthReport, HealthStatus, LoadOptions, Migration, ModelUsageEntry, ParsedManifest, PushModeOptions, RefType, ReporterOptions, ResolverOptions, RuleEvidenceSummary, RuleResult, RuleSeverity, SecretBackend, Severity, SuppressionRecord, UnverifiedRule, UsageSnapshot };