@gleanwork/mcp-server-tester 2.0.0-beta.0 → 2.0.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +3854 -1219
- package/dist/fixtures/mcp.d.ts +3 -0
- package/dist/fixtures/mcp.js +2 -2
- package/dist/fixtures/mcp.js.map +1 -1
- package/dist/{index-aX_tCfTD.d.cts → index-CwFHKIoN.d.cts} +70 -1
- package/dist/{index-aX_tCfTD.d.ts → index-CwFHKIoN.d.ts} +70 -1
- package/dist/index.cjs +5077 -2542
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -2
- package/dist/index.d.ts +3 -2
- package/dist/index.js +5091 -2557
- package/dist/index.js.map +1 -1
- package/dist/reporters/mcpReporter.d.cts +3 -0
- package/dist/reporters/mcpReporter.d.ts +3 -0
- package/dist/types/index.d.cts +1 -1
- package/dist/types/index.d.ts +1 -1
- package/package.json +7 -3
- package/scripts/cowork-requirements.txt +5 -0
- package/scripts/cowork_computer_use.py +409 -0
|
@@ -7,6 +7,22 @@ import { OAuthClientMetadata, OAuthClientInformationFull, OAuthTokens } from '@m
|
|
|
7
7
|
import * as oauth from 'oauth4webapi';
|
|
8
8
|
import * as playwright_test from 'playwright/test';
|
|
9
9
|
|
|
10
|
+
/** Sanitized host evidence, not an evaluation verdict or raw process log. */
|
|
11
|
+
interface HostDiagnostics {
|
|
12
|
+
failureKind?: 'startup' | 'timeout' | 'process' | 'output';
|
|
13
|
+
claudeStartup?: {
|
|
14
|
+
status: 'ready' | 'failed' | 'missing';
|
|
15
|
+
elapsedMs: number;
|
|
16
|
+
model?: string;
|
|
17
|
+
version?: string;
|
|
18
|
+
servers: Array<{
|
|
19
|
+
name: string;
|
|
20
|
+
status: 'connected' | 'pending' | 'failed' | 'needs-auth' | 'disabled' | 'unknown';
|
|
21
|
+
tools: string[];
|
|
22
|
+
}>;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
|
|
10
26
|
/**
|
|
11
27
|
* Validator Types
|
|
12
28
|
*
|
|
@@ -433,6 +449,14 @@ declare function isStdioConfig(config: MCPConfig): config is StdioMCPConfig;
|
|
|
433
449
|
*/
|
|
434
450
|
declare function isHttpConfig(config: MCPConfig): config is HttpMCPConfig;
|
|
435
451
|
|
|
452
|
+
/** Native Cowork configuration only; this does not authorize the eval runner to
|
|
453
|
+
* execute writes. Unset/false preserves Cowork's existing approval behavior.
|
|
454
|
+
*/
|
|
455
|
+
declare const CoworkSetupConfigSchema: z.ZodObject<{
|
|
456
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
457
|
+
}, z.core.$strict>;
|
|
458
|
+
type CoworkSetupConfig = z.infer<typeof CoworkSetupConfigSchema>;
|
|
459
|
+
|
|
436
460
|
/** A tagged configuration block resolved by a public registry. */
|
|
437
461
|
interface TaggedConfig {
|
|
438
462
|
type: string;
|
|
@@ -461,6 +485,7 @@ interface EvalArm {
|
|
|
461
485
|
scenarioTemplate?: string;
|
|
462
486
|
metrics?: ExtensionConfig[];
|
|
463
487
|
judges?: ExtensionConfig[];
|
|
488
|
+
coworkSetup?: CoworkSetupConfig;
|
|
464
489
|
}
|
|
465
490
|
/** A complete, organization-neutral evaluation manifest. */
|
|
466
491
|
interface EvalManifest {
|
|
@@ -474,6 +499,7 @@ interface EvalManifest {
|
|
|
474
499
|
arms?: EvalArm[];
|
|
475
500
|
metrics?: ExtensionConfig[];
|
|
476
501
|
judges?: ExtensionConfig[];
|
|
502
|
+
coworkSetup?: CoworkSetupConfig;
|
|
477
503
|
results?: {
|
|
478
504
|
store: ExtensionConfig;
|
|
479
505
|
};
|
|
@@ -651,6 +677,9 @@ declare const EvalManifestSchema: z.ZodObject<{
|
|
|
651
677
|
judges: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
652
678
|
type: z.ZodString;
|
|
653
679
|
}, z.core.$loose>]>>>;
|
|
680
|
+
coworkSetup: z.ZodOptional<z.ZodObject<{
|
|
681
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
682
|
+
}, z.core.$strict>>;
|
|
654
683
|
}, z.core.$strict>>>;
|
|
655
684
|
metrics: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
656
685
|
type: z.ZodString;
|
|
@@ -658,6 +687,9 @@ declare const EvalManifestSchema: z.ZodObject<{
|
|
|
658
687
|
judges: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
659
688
|
type: z.ZodString;
|
|
660
689
|
}, z.core.$loose>]>>>;
|
|
690
|
+
coworkSetup: z.ZodOptional<z.ZodObject<{
|
|
691
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
692
|
+
}, z.core.$strict>>;
|
|
661
693
|
results: z.ZodOptional<z.ZodObject<{
|
|
662
694
|
store: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
663
695
|
type: z.ZodString;
|
|
@@ -864,6 +896,8 @@ type CLIOutputFormat = 'stream-json' | 'json';
|
|
|
864
896
|
* ```
|
|
865
897
|
*/
|
|
866
898
|
interface CLIConfig {
|
|
899
|
+
/** Claude Code only: validate these MCP servers in its startup stream. */
|
|
900
|
+
claudeMcpServers?: string[];
|
|
867
901
|
/** Child-process-only environment overrides. Undefined removes an inherited key. */
|
|
868
902
|
env?: Record<string, string | undefined>;
|
|
869
903
|
/**
|
|
@@ -1012,11 +1046,15 @@ interface LLMToolCall {
|
|
|
1012
1046
|
id?: string;
|
|
1013
1047
|
/** Tool result text, when the host surfaces it (paired to this call) */
|
|
1014
1048
|
output?: string;
|
|
1049
|
+
/** Explicit tool-result error status; absent when not observed. */
|
|
1050
|
+
isError?: boolean;
|
|
1015
1051
|
}
|
|
1016
1052
|
/**
|
|
1017
1053
|
* Result from an MCP host simulation
|
|
1018
1054
|
*/
|
|
1019
1055
|
interface MCPHostSimulationResult {
|
|
1056
|
+
/** Sanitized startup evidence, retained even when execution fails. */
|
|
1057
|
+
diagnostics?: HostDiagnostics;
|
|
1020
1058
|
/** Whether the simulation succeeded */
|
|
1021
1059
|
success: boolean;
|
|
1022
1060
|
/** Tool calls made by the LLM */
|
|
@@ -1752,6 +1790,7 @@ declare const EvalCaseSchema: z.ZodObject<{
|
|
|
1752
1790
|
"stream-json": "stream-json";
|
|
1753
1791
|
json: "json";
|
|
1754
1792
|
}>>;
|
|
1793
|
+
claudeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
1755
1794
|
timeout: z.ZodOptional<z.ZodNumber>;
|
|
1756
1795
|
}, z.core.$strip>>;
|
|
1757
1796
|
mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
|
|
@@ -2068,6 +2107,7 @@ declare const EvalDatasetSchema: z.ZodObject<{
|
|
|
2068
2107
|
"stream-json": "stream-json";
|
|
2069
2108
|
json: "json";
|
|
2070
2109
|
}>>;
|
|
2110
|
+
claudeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
2071
2111
|
timeout: z.ZodOptional<z.ZodNumber>;
|
|
2072
2112
|
}, z.core.$strip>>;
|
|
2073
2113
|
mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
|
|
@@ -2626,10 +2666,14 @@ interface IterationResult {
|
|
|
2626
2666
|
name: string;
|
|
2627
2667
|
}>;
|
|
2628
2668
|
};
|
|
2669
|
+
/** Sanitized host evidence for this specific attempt. */
|
|
2670
|
+
hostDiagnostics?: HostDiagnostics;
|
|
2629
2671
|
/** Evidence level retained even when raw responses are redacted. */
|
|
2630
2672
|
hostEvidence?: HostEvidence;
|
|
2631
2673
|
/** Token usage from mcp_host LLM simulation in this iteration */
|
|
2632
2674
|
hostUsage?: UsageMetrics;
|
|
2675
|
+
/** Native numeric host measurements, retained after response redaction. */
|
|
2676
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2633
2677
|
/** External host metadata for this iteration */
|
|
2634
2678
|
externalHost?: ExternalHostMetadata;
|
|
2635
2679
|
}
|
|
@@ -2809,6 +2853,8 @@ interface EvalCaseResult {
|
|
|
2809
2853
|
name: string;
|
|
2810
2854
|
}>;
|
|
2811
2855
|
};
|
|
2856
|
+
/** Sanitized host evidence; each iteration retains its own diagnostics. */
|
|
2857
|
+
hostDiagnostics?: HostDiagnostics;
|
|
2812
2858
|
/** Evidence level retained in persisted comparisons after response redaction. */
|
|
2813
2859
|
hostEvidence?: HostEvidence;
|
|
2814
2860
|
/**
|
|
@@ -2816,6 +2862,8 @@ interface EvalCaseResult {
|
|
|
2816
2862
|
* Summed across all iterations. Only populated for mcp_host mode cases.
|
|
2817
2863
|
*/
|
|
2818
2864
|
hostUsage?: UsageMetrics;
|
|
2865
|
+
/** Native single-iteration measurements; multi-iteration values live in iterationResults. */
|
|
2866
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2819
2867
|
/**
|
|
2820
2868
|
* External host trace and evidence metadata.
|
|
2821
2869
|
* Populated for external_host mode cases.
|
|
@@ -2943,6 +2991,9 @@ interface EvalExecutionResult {
|
|
|
2943
2991
|
response: unknown;
|
|
2944
2992
|
error?: string;
|
|
2945
2993
|
hostUsage?: UsageMetrics;
|
|
2994
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2995
|
+
/** Host time already spent outside the current evaluation timer. */
|
|
2996
|
+
preExecutionDurationMs?: number;
|
|
2946
2997
|
evidence?: HostEvidence;
|
|
2947
2998
|
}
|
|
2948
2999
|
|
|
@@ -3306,14 +3357,29 @@ interface HostEvent {
|
|
|
3306
3357
|
server?: string;
|
|
3307
3358
|
arguments?: Record<string, unknown>;
|
|
3308
3359
|
output?: string;
|
|
3360
|
+
/** Explicit tool-result error status, absent when not observed. */
|
|
3361
|
+
isError?: boolean;
|
|
3362
|
+
rawName?: string;
|
|
3309
3363
|
id?: string;
|
|
3310
3364
|
}
|
|
3311
3365
|
/** One execution trace. Hosts never return evaluation verdicts. */
|
|
3312
3366
|
interface HostRunResult {
|
|
3367
|
+
diagnostics?: HostDiagnostics;
|
|
3313
3368
|
finalText: string;
|
|
3314
3369
|
events: HostEvent[];
|
|
3315
3370
|
error?: string;
|
|
3316
3371
|
usage?: UsageMetrics;
|
|
3372
|
+
/** Native and driver observations remain separately scoped; UI actions are not LLM usage. */
|
|
3373
|
+
telemetry?: Record<string, unknown>;
|
|
3374
|
+
/** Per-request wall time, excluding shared batch setup and cleanup. */
|
|
3375
|
+
durationMs?: number;
|
|
3376
|
+
llmDurationMs?: number;
|
|
3377
|
+
}
|
|
3378
|
+
interface HostBatchRequest {
|
|
3379
|
+
caseId: string;
|
|
3380
|
+
iteration: number;
|
|
3381
|
+
input: HostRunInput;
|
|
3382
|
+
config: HostConfig;
|
|
3317
3383
|
}
|
|
3318
3384
|
/** Public host extension point. */
|
|
3319
3385
|
interface HostDefinition {
|
|
@@ -3322,6 +3388,8 @@ interface HostDefinition {
|
|
|
3322
3388
|
createConfig?(options?: Record<string, unknown>): MCPHostConfig;
|
|
3323
3389
|
/** Missing evidence declarations are treated as unverified. */
|
|
3324
3390
|
readonly evidence?: HostEvidence;
|
|
3391
|
+
/** Ordered traces for all selected iterations. The framework owns verdicts. */
|
|
3392
|
+
runBatch?(requests: HostBatchRequest[], context: HostRunContext): Promise<HostRunResult[]>;
|
|
3325
3393
|
run?(input: HostRunInput, config: HostConfig, context: HostRunContext): Promise<HostRunResult>;
|
|
3326
3394
|
}
|
|
3327
3395
|
/** Values emitted by a metric for one evaluation case. */
|
|
@@ -5310,6 +5378,7 @@ declare function runConformanceChecks(mcp: MCPFixtureApi, options?: MCPConforman
|
|
|
5310
5378
|
* - 'none': No authentication
|
|
5311
5379
|
*/
|
|
5312
5380
|
type AuthType = 'oauth' | 'api-token' | 'none';
|
|
5381
|
+
|
|
5313
5382
|
/**
|
|
5314
5383
|
* Source of test results
|
|
5315
5384
|
*
|
|
@@ -5370,4 +5439,4 @@ type ExpectationResultMap = Partial<Record<ExpectationType, EvalExpectationResul
|
|
|
5370
5439
|
*/
|
|
5371
5440
|
type ExpectationBreakdown = Partial<Record<ExpectationType, number>>;
|
|
5372
5441
|
|
|
5373
|
-
export { type CompareEvalRunsOptions as $, type AuthType as A, type HostDriverConfig as B, type ExternalHostCapabilitiesConfig as C, type DatasetSource as D, type ExtensionConfig as E, type JudgeConfig as F, type Judge as G, type HostDefinition as H, BUILT_IN_RUBRICS as I, type JudgeMatcherOptions as J, type BuiltInRubric as K, type LLMProvider as L, type MCPFixtureApi as M, type BuiltInSanitizer as N, type OAuthSetupConfig as O, type PatternValidatorOptions as P, type CLIConfig as Q, type RubricSpec as R, type SchemaValidatorOptions as S, type TextValidatorOptions as T, CLIOAuthClient as U, type ValidationResult as V, type CLIOAuthClientConfig as W, type CLIOAuthResult as X, type CLIOutputFormat as Y, type CaseComparisonResult as Z, type ClientCredentialsConfig as _, type MCPHostConfig as a, type
|
|
5442
|
+
export { type CompareEvalRunsOptions as $, type AuthType as A, type HostDriverConfig as B, type ExternalHostCapabilitiesConfig as C, type DatasetSource as D, type ExtensionConfig as E, type JudgeConfig as F, type Judge as G, type HostDefinition as H, BUILT_IN_RUBRICS as I, type JudgeMatcherOptions as J, type BuiltInRubric as K, type LLMProvider as L, type MCPFixtureApi as M, type BuiltInSanitizer as N, type OAuthSetupConfig as O, type PatternValidatorOptions as P, type CLIConfig as Q, type RubricSpec as R, type SchemaValidatorOptions as S, type TextValidatorOptions as T, CLIOAuthClient as U, type ValidationResult as V, type CLIOAuthClientConfig as W, type CLIOAuthResult as X, type CLIOutputFormat as Y, type CaseComparisonResult as Z, type ClientCredentialsConfig as _, type MCPHostConfig as a, type HttpMCPConfig as a$, type ComparisonOutcome as a0, type ContentBlock as a1, type CreateMCPClientOptions as a2, type CustomJudgeExecutor as a3, type CustomJudgeResult as a4, type DatasetSourceContext as a5, DiscoveryError as a6, ENV_VAR_NAMES as a7, type EvalArm as a8, type EvalCase as a9, type ExpectationType as aA, type ExperimentMetric as aB, type ExternalHostCapabilityBinding as aC, type ExternalHostCapabilityContext as aD, type ExternalHostFailureKind as aE, type ExternalHostMetadata as aF, type ExternalHostSession as aG, type ExternalHostSimulationResult as aH, type ExternalHostType as aI, type FieldRemovalSanitizer as aJ, FileEvalResultStore as aK, type FileEvalResultStoreConfig as aL, GCSEvalResultStore as aM, type GCSEvalResultStoreConfig as aN, type HostArtifact as aO, type HostBatchRequest as aP, type HostCapability as aQ, type HostConfig as aR, type HostConfigPatch as aS, type HostDiagnostics as aT, type HostEvent as aU, type HostEvidence as aV, type HostRunContext$1 as aW, type HostRunInput as aX, type HostRunOptions as aY, type HostRunResult as aZ, type HostType as a_, type EvalCaseComparison as aa, type EvalCaseComparisonOutcome as ab, type EvalCaseRequest as ac, EvalCaseSchema as ad, type EvalContext as ae, EvalDatasetSchema as af, type EvalExpectBlock as ag, type EvalExpectationResult as ah, type EvalManifestInput as ai, EvalManifestSchema as aj, type EvalMode as ak, type EvalResultStore as al, type EvalResultStoreConfig as am, type EvalResultStoreLike as an, type EvalRunComparisonLabels as ao, type EvalRunComparisonResult as ap, type EvalRunMetadata as aq, type EvalRunnerOptions as ar, type EvalSummaryGenerator as as, type EvaluationArmResult as at, type HostRunContext as au, type EvaluationSuiteOptions as av, type EvaluationSuiteResult as aw, type EvidenceSource as ax, type ExpectationBreakdown as ay, type ExpectationResultMap as az, type MCPHostSimulationResult as b, type ToolMetadataOverride as b$, type IterationResult as b0, type JudgeExpectConfig as b1, type JudgeResult as b2, type JudgeValidatorConfig as b3, type LLMToolCall as b4, type ListStoredArtifactsOptions as b5, type LoadDatasetOptions as b6, type MCPAuthConfig as b7, type MCPAuthFixtures as b8, type MCPClientCredentialsConfig as b9, type RegexSanitizer as bA, type ResultSource as bB, type RunSummary as bC, type RunTelemetry as bD, type SaveBaselineOptions as bE, type SaveEvalRunComparisonOptions as bF, type SaveServerComparisonOptions as bG, type SchemaRegistry as bH, type SerializedEvalDataset as bI, type ServerComparisonOptions as bJ, type ServerComparisonResult as bK, SnapshotSanitizers as bL, type StdioMCPConfig as bM, type StoredArtifactKind as bN, type StoredArtifactSummary as bO, type StoredClientInfo as bP, type StoredEvalArtifact as bQ, type StoredEvalArtifactMetadata as bR, type StoredEvalResultLoadOptions as bS, type StoredEvalResultRef as bT, type StoredEvalResultSaveOptions as bU, type StoredEvalRunRef as bV, type StoredOAuthState as bW, type StoredServerMetadata as bX, type StoredTokens as bY, type TaggedConfig as bZ, type TokenResult as b_, MCPConfigSchema as ba, type MCPConformanceCheck as bb, type MCPConformanceOptions as bc, type MCPConformanceRaw as bd, type MCPConformanceResult as be, type MCPConformanceResultData as bf, type MCPEvalData as bg, type MCPEvalHistoricalSummary as bh, type MCPEvalReporterConfig as bi, type MCPEvalRunData as bj, type MCPFixtureOptions as bk, type MCPHostCapabilities as bl, type MCPHostSimulator as bm, type MCPOAuthConfig as bn, type MCPServerCapabilitiesData as bo, MCP_PROTOCOL_VERSION as bp, type MetricKind as bq, type NormalizedToolResponse as br, type ObservationConfidence as bs, PlaywrightOAuthClientProvider as bt, type PlaywrightOAuthClientProviderConfig as bu, type PredicateResult as bv, type ProposeVariantsContext as bw, type ProtectedResourceDiscoveryResult as bx, type ProtectedResourceMetadata as by, type ProviderKind as bz, type SizeValidatorOptions as c, type ToolOverrideVariant as c0, type TraceSource as c1, type UsageMetrics as c2, type VariantCandidateResult as c3, type VariantExperimentOptions as c4, type VariantExperimentReason as c5, type VariantExperimentResult as c6, type VariantExperimentRound as c7, type VariantImprovementProposal as c8, type VariantRecommendation as c9, normalizeToolResponse as cA, performClientCredentialsFlow as cB, refreshAccessToken as cC, registerJudge as cD, resolveDatasetPaths as cE, resolveEvalResultStore as cF, resolveRubric as cG, runConformanceChecks as cH, runEvalCase as cI, runEvalDataset as cJ, runServerComparison as cK, runVariantExperiment as cL, saveBaseline as cM, saveEvalRunComparison as cN, saveServerComparison as cO, validateEvalCase as cP, validateEvalDataset as cQ, validateJudge as cR, validateMCPConfig as cS, validateToolCallCount as cT, validateToolCalls as cU, closeMCPClient as ca, compareEvalRuns as cb, createDefaultArtifactId as cc, createEvalResultStore as cd, createMCPClientForConfig as ce, createMCPFixture as cf, createStoredEvalArtifact as cg, defaultEnvironmentMetadata as ch, discoverAuthorizationServer as ci, discoverProtectedResource as cj, extractText as ck, hasValidTokens as cl, injectTokens as cm, isBuiltInRubric as cn, isEvalResultStore as co, isHttpConfig as cp, isStdioConfig as cq, loadBaseline as cr, loadEvalDataset as cs, loadEvalDatasetFromObject as ct, loadEvalManifest as cu, loadEvalManifestFromObject as cv, loadStoredEvalRunnerResult as cw, loadTokens as cx, loadTokensFromEnv as cy, test as cz, type SnapshotSanitizer as d, type ToolPredicate as e, type ToolCallExpectation as f, type ToolCallCountOptions as g, type JudgeDefinition as h, type MetricDefinition as i, type ResultStoreDefinition as j, type EvalManifest as k, type EvalCaseResult as l, type MetricValue as m, type ResolvedMetric as n, type EvalDataset as o, type MCPConfig as p, type DatasetConfig as q, type EvalRunnerResult as r, type EvaluationSummary as s, type EvaluationBatchItem as t, type EvaluationBatchOptions as u, type EvaluationBatchResult as v, type ExternalHostConfig as w, type ExternalHostRunResult as x, type ExternalHostCapabilityImplementation as y, type HostDriverId as z };
|
|
@@ -7,6 +7,22 @@ import { OAuthClientMetadata, OAuthClientInformationFull, OAuthTokens } from '@m
|
|
|
7
7
|
import * as oauth from 'oauth4webapi';
|
|
8
8
|
import * as playwright_test from 'playwright/test';
|
|
9
9
|
|
|
10
|
+
/** Sanitized host evidence, not an evaluation verdict or raw process log. */
|
|
11
|
+
interface HostDiagnostics {
|
|
12
|
+
failureKind?: 'startup' | 'timeout' | 'process' | 'output';
|
|
13
|
+
claudeStartup?: {
|
|
14
|
+
status: 'ready' | 'failed' | 'missing';
|
|
15
|
+
elapsedMs: number;
|
|
16
|
+
model?: string;
|
|
17
|
+
version?: string;
|
|
18
|
+
servers: Array<{
|
|
19
|
+
name: string;
|
|
20
|
+
status: 'connected' | 'pending' | 'failed' | 'needs-auth' | 'disabled' | 'unknown';
|
|
21
|
+
tools: string[];
|
|
22
|
+
}>;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
|
|
10
26
|
/**
|
|
11
27
|
* Validator Types
|
|
12
28
|
*
|
|
@@ -433,6 +449,14 @@ declare function isStdioConfig(config: MCPConfig): config is StdioMCPConfig;
|
|
|
433
449
|
*/
|
|
434
450
|
declare function isHttpConfig(config: MCPConfig): config is HttpMCPConfig;
|
|
435
451
|
|
|
452
|
+
/** Native Cowork configuration only; this does not authorize the eval runner to
|
|
453
|
+
* execute writes. Unset/false preserves Cowork's existing approval behavior.
|
|
454
|
+
*/
|
|
455
|
+
declare const CoworkSetupConfigSchema: z.ZodObject<{
|
|
456
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
457
|
+
}, z.core.$strict>;
|
|
458
|
+
type CoworkSetupConfig = z.infer<typeof CoworkSetupConfigSchema>;
|
|
459
|
+
|
|
436
460
|
/** A tagged configuration block resolved by a public registry. */
|
|
437
461
|
interface TaggedConfig {
|
|
438
462
|
type: string;
|
|
@@ -461,6 +485,7 @@ interface EvalArm {
|
|
|
461
485
|
scenarioTemplate?: string;
|
|
462
486
|
metrics?: ExtensionConfig[];
|
|
463
487
|
judges?: ExtensionConfig[];
|
|
488
|
+
coworkSetup?: CoworkSetupConfig;
|
|
464
489
|
}
|
|
465
490
|
/** A complete, organization-neutral evaluation manifest. */
|
|
466
491
|
interface EvalManifest {
|
|
@@ -474,6 +499,7 @@ interface EvalManifest {
|
|
|
474
499
|
arms?: EvalArm[];
|
|
475
500
|
metrics?: ExtensionConfig[];
|
|
476
501
|
judges?: ExtensionConfig[];
|
|
502
|
+
coworkSetup?: CoworkSetupConfig;
|
|
477
503
|
results?: {
|
|
478
504
|
store: ExtensionConfig;
|
|
479
505
|
};
|
|
@@ -651,6 +677,9 @@ declare const EvalManifestSchema: z.ZodObject<{
|
|
|
651
677
|
judges: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
652
678
|
type: z.ZodString;
|
|
653
679
|
}, z.core.$loose>]>>>;
|
|
680
|
+
coworkSetup: z.ZodOptional<z.ZodObject<{
|
|
681
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
682
|
+
}, z.core.$strict>>;
|
|
654
683
|
}, z.core.$strict>>>;
|
|
655
684
|
metrics: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
656
685
|
type: z.ZodString;
|
|
@@ -658,6 +687,9 @@ declare const EvalManifestSchema: z.ZodObject<{
|
|
|
658
687
|
judges: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
659
688
|
type: z.ZodString;
|
|
660
689
|
}, z.core.$loose>]>>>;
|
|
690
|
+
coworkSetup: z.ZodOptional<z.ZodObject<{
|
|
691
|
+
approveWriteTools: z.ZodOptional<z.ZodBoolean>;
|
|
692
|
+
}, z.core.$strict>>;
|
|
661
693
|
results: z.ZodOptional<z.ZodObject<{
|
|
662
694
|
store: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
|
|
663
695
|
type: z.ZodString;
|
|
@@ -864,6 +896,8 @@ type CLIOutputFormat = 'stream-json' | 'json';
|
|
|
864
896
|
* ```
|
|
865
897
|
*/
|
|
866
898
|
interface CLIConfig {
|
|
899
|
+
/** Claude Code only: validate these MCP servers in its startup stream. */
|
|
900
|
+
claudeMcpServers?: string[];
|
|
867
901
|
/** Child-process-only environment overrides. Undefined removes an inherited key. */
|
|
868
902
|
env?: Record<string, string | undefined>;
|
|
869
903
|
/**
|
|
@@ -1012,11 +1046,15 @@ interface LLMToolCall {
|
|
|
1012
1046
|
id?: string;
|
|
1013
1047
|
/** Tool result text, when the host surfaces it (paired to this call) */
|
|
1014
1048
|
output?: string;
|
|
1049
|
+
/** Explicit tool-result error status; absent when not observed. */
|
|
1050
|
+
isError?: boolean;
|
|
1015
1051
|
}
|
|
1016
1052
|
/**
|
|
1017
1053
|
* Result from an MCP host simulation
|
|
1018
1054
|
*/
|
|
1019
1055
|
interface MCPHostSimulationResult {
|
|
1056
|
+
/** Sanitized startup evidence, retained even when execution fails. */
|
|
1057
|
+
diagnostics?: HostDiagnostics;
|
|
1020
1058
|
/** Whether the simulation succeeded */
|
|
1021
1059
|
success: boolean;
|
|
1022
1060
|
/** Tool calls made by the LLM */
|
|
@@ -1752,6 +1790,7 @@ declare const EvalCaseSchema: z.ZodObject<{
|
|
|
1752
1790
|
"stream-json": "stream-json";
|
|
1753
1791
|
json: "json";
|
|
1754
1792
|
}>>;
|
|
1793
|
+
claudeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
1755
1794
|
timeout: z.ZodOptional<z.ZodNumber>;
|
|
1756
1795
|
}, z.core.$strip>>;
|
|
1757
1796
|
mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
|
|
@@ -2068,6 +2107,7 @@ declare const EvalDatasetSchema: z.ZodObject<{
|
|
|
2068
2107
|
"stream-json": "stream-json";
|
|
2069
2108
|
json: "json";
|
|
2070
2109
|
}>>;
|
|
2110
|
+
claudeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
2071
2111
|
timeout: z.ZodOptional<z.ZodNumber>;
|
|
2072
2112
|
}, z.core.$strip>>;
|
|
2073
2113
|
mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
|
|
@@ -2626,10 +2666,14 @@ interface IterationResult {
|
|
|
2626
2666
|
name: string;
|
|
2627
2667
|
}>;
|
|
2628
2668
|
};
|
|
2669
|
+
/** Sanitized host evidence for this specific attempt. */
|
|
2670
|
+
hostDiagnostics?: HostDiagnostics;
|
|
2629
2671
|
/** Evidence level retained even when raw responses are redacted. */
|
|
2630
2672
|
hostEvidence?: HostEvidence;
|
|
2631
2673
|
/** Token usage from mcp_host LLM simulation in this iteration */
|
|
2632
2674
|
hostUsage?: UsageMetrics;
|
|
2675
|
+
/** Native numeric host measurements, retained after response redaction. */
|
|
2676
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2633
2677
|
/** External host metadata for this iteration */
|
|
2634
2678
|
externalHost?: ExternalHostMetadata;
|
|
2635
2679
|
}
|
|
@@ -2809,6 +2853,8 @@ interface EvalCaseResult {
|
|
|
2809
2853
|
name: string;
|
|
2810
2854
|
}>;
|
|
2811
2855
|
};
|
|
2856
|
+
/** Sanitized host evidence; each iteration retains its own diagnostics. */
|
|
2857
|
+
hostDiagnostics?: HostDiagnostics;
|
|
2812
2858
|
/** Evidence level retained in persisted comparisons after response redaction. */
|
|
2813
2859
|
hostEvidence?: HostEvidence;
|
|
2814
2860
|
/**
|
|
@@ -2816,6 +2862,8 @@ interface EvalCaseResult {
|
|
|
2816
2862
|
* Summed across all iterations. Only populated for mcp_host mode cases.
|
|
2817
2863
|
*/
|
|
2818
2864
|
hostUsage?: UsageMetrics;
|
|
2865
|
+
/** Native single-iteration measurements; multi-iteration values live in iterationResults. */
|
|
2866
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2819
2867
|
/**
|
|
2820
2868
|
* External host trace and evidence metadata.
|
|
2821
2869
|
* Populated for external_host mode cases.
|
|
@@ -2943,6 +2991,9 @@ interface EvalExecutionResult {
|
|
|
2943
2991
|
response: unknown;
|
|
2944
2992
|
error?: string;
|
|
2945
2993
|
hostUsage?: UsageMetrics;
|
|
2994
|
+
hostTelemetry?: Record<string, unknown>;
|
|
2995
|
+
/** Host time already spent outside the current evaluation timer. */
|
|
2996
|
+
preExecutionDurationMs?: number;
|
|
2946
2997
|
evidence?: HostEvidence;
|
|
2947
2998
|
}
|
|
2948
2999
|
|
|
@@ -3306,14 +3357,29 @@ interface HostEvent {
|
|
|
3306
3357
|
server?: string;
|
|
3307
3358
|
arguments?: Record<string, unknown>;
|
|
3308
3359
|
output?: string;
|
|
3360
|
+
/** Explicit tool-result error status, absent when not observed. */
|
|
3361
|
+
isError?: boolean;
|
|
3362
|
+
rawName?: string;
|
|
3309
3363
|
id?: string;
|
|
3310
3364
|
}
|
|
3311
3365
|
/** One execution trace. Hosts never return evaluation verdicts. */
|
|
3312
3366
|
interface HostRunResult {
|
|
3367
|
+
diagnostics?: HostDiagnostics;
|
|
3313
3368
|
finalText: string;
|
|
3314
3369
|
events: HostEvent[];
|
|
3315
3370
|
error?: string;
|
|
3316
3371
|
usage?: UsageMetrics;
|
|
3372
|
+
/** Native and driver observations remain separately scoped; UI actions are not LLM usage. */
|
|
3373
|
+
telemetry?: Record<string, unknown>;
|
|
3374
|
+
/** Per-request wall time, excluding shared batch setup and cleanup. */
|
|
3375
|
+
durationMs?: number;
|
|
3376
|
+
llmDurationMs?: number;
|
|
3377
|
+
}
|
|
3378
|
+
interface HostBatchRequest {
|
|
3379
|
+
caseId: string;
|
|
3380
|
+
iteration: number;
|
|
3381
|
+
input: HostRunInput;
|
|
3382
|
+
config: HostConfig;
|
|
3317
3383
|
}
|
|
3318
3384
|
/** Public host extension point. */
|
|
3319
3385
|
interface HostDefinition {
|
|
@@ -3322,6 +3388,8 @@ interface HostDefinition {
|
|
|
3322
3388
|
createConfig?(options?: Record<string, unknown>): MCPHostConfig;
|
|
3323
3389
|
/** Missing evidence declarations are treated as unverified. */
|
|
3324
3390
|
readonly evidence?: HostEvidence;
|
|
3391
|
+
/** Ordered traces for all selected iterations. The framework owns verdicts. */
|
|
3392
|
+
runBatch?(requests: HostBatchRequest[], context: HostRunContext): Promise<HostRunResult[]>;
|
|
3325
3393
|
run?(input: HostRunInput, config: HostConfig, context: HostRunContext): Promise<HostRunResult>;
|
|
3326
3394
|
}
|
|
3327
3395
|
/** Values emitted by a metric for one evaluation case. */
|
|
@@ -5310,6 +5378,7 @@ declare function runConformanceChecks(mcp: MCPFixtureApi, options?: MCPConforman
|
|
|
5310
5378
|
* - 'none': No authentication
|
|
5311
5379
|
*/
|
|
5312
5380
|
type AuthType = 'oauth' | 'api-token' | 'none';
|
|
5381
|
+
|
|
5313
5382
|
/**
|
|
5314
5383
|
* Source of test results
|
|
5315
5384
|
*
|
|
@@ -5370,4 +5439,4 @@ type ExpectationResultMap = Partial<Record<ExpectationType, EvalExpectationResul
|
|
|
5370
5439
|
*/
|
|
5371
5440
|
type ExpectationBreakdown = Partial<Record<ExpectationType, number>>;
|
|
5372
5441
|
|
|
5373
|
-
export { type CompareEvalRunsOptions as $, type AuthType as A, type HostDriverConfig as B, type ExternalHostCapabilitiesConfig as C, type DatasetSource as D, type ExtensionConfig as E, type JudgeConfig as F, type Judge as G, type HostDefinition as H, BUILT_IN_RUBRICS as I, type JudgeMatcherOptions as J, type BuiltInRubric as K, type LLMProvider as L, type MCPFixtureApi as M, type BuiltInSanitizer as N, type OAuthSetupConfig as O, type PatternValidatorOptions as P, type CLIConfig as Q, type RubricSpec as R, type SchemaValidatorOptions as S, type TextValidatorOptions as T, CLIOAuthClient as U, type ValidationResult as V, type CLIOAuthClientConfig as W, type CLIOAuthResult as X, type CLIOutputFormat as Y, type CaseComparisonResult as Z, type ClientCredentialsConfig as _, type MCPHostConfig as a, type
|
|
5442
|
+
export { type CompareEvalRunsOptions as $, type AuthType as A, type HostDriverConfig as B, type ExternalHostCapabilitiesConfig as C, type DatasetSource as D, type ExtensionConfig as E, type JudgeConfig as F, type Judge as G, type HostDefinition as H, BUILT_IN_RUBRICS as I, type JudgeMatcherOptions as J, type BuiltInRubric as K, type LLMProvider as L, type MCPFixtureApi as M, type BuiltInSanitizer as N, type OAuthSetupConfig as O, type PatternValidatorOptions as P, type CLIConfig as Q, type RubricSpec as R, type SchemaValidatorOptions as S, type TextValidatorOptions as T, CLIOAuthClient as U, type ValidationResult as V, type CLIOAuthClientConfig as W, type CLIOAuthResult as X, type CLIOutputFormat as Y, type CaseComparisonResult as Z, type ClientCredentialsConfig as _, type MCPHostConfig as a, type HttpMCPConfig as a$, type ComparisonOutcome as a0, type ContentBlock as a1, type CreateMCPClientOptions as a2, type CustomJudgeExecutor as a3, type CustomJudgeResult as a4, type DatasetSourceContext as a5, DiscoveryError as a6, ENV_VAR_NAMES as a7, type EvalArm as a8, type EvalCase as a9, type ExpectationType as aA, type ExperimentMetric as aB, type ExternalHostCapabilityBinding as aC, type ExternalHostCapabilityContext as aD, type ExternalHostFailureKind as aE, type ExternalHostMetadata as aF, type ExternalHostSession as aG, type ExternalHostSimulationResult as aH, type ExternalHostType as aI, type FieldRemovalSanitizer as aJ, FileEvalResultStore as aK, type FileEvalResultStoreConfig as aL, GCSEvalResultStore as aM, type GCSEvalResultStoreConfig as aN, type HostArtifact as aO, type HostBatchRequest as aP, type HostCapability as aQ, type HostConfig as aR, type HostConfigPatch as aS, type HostDiagnostics as aT, type HostEvent as aU, type HostEvidence as aV, type HostRunContext$1 as aW, type HostRunInput as aX, type HostRunOptions as aY, type HostRunResult as aZ, type HostType as a_, type EvalCaseComparison as aa, type EvalCaseComparisonOutcome as ab, type EvalCaseRequest as ac, EvalCaseSchema as ad, type EvalContext as ae, EvalDatasetSchema as af, type EvalExpectBlock as ag, type EvalExpectationResult as ah, type EvalManifestInput as ai, EvalManifestSchema as aj, type EvalMode as ak, type EvalResultStore as al, type EvalResultStoreConfig as am, type EvalResultStoreLike as an, type EvalRunComparisonLabels as ao, type EvalRunComparisonResult as ap, type EvalRunMetadata as aq, type EvalRunnerOptions as ar, type EvalSummaryGenerator as as, type EvaluationArmResult as at, type HostRunContext as au, type EvaluationSuiteOptions as av, type EvaluationSuiteResult as aw, type EvidenceSource as ax, type ExpectationBreakdown as ay, type ExpectationResultMap as az, type MCPHostSimulationResult as b, type ToolMetadataOverride as b$, type IterationResult as b0, type JudgeExpectConfig as b1, type JudgeResult as b2, type JudgeValidatorConfig as b3, type LLMToolCall as b4, type ListStoredArtifactsOptions as b5, type LoadDatasetOptions as b6, type MCPAuthConfig as b7, type MCPAuthFixtures as b8, type MCPClientCredentialsConfig as b9, type RegexSanitizer as bA, type ResultSource as bB, type RunSummary as bC, type RunTelemetry as bD, type SaveBaselineOptions as bE, type SaveEvalRunComparisonOptions as bF, type SaveServerComparisonOptions as bG, type SchemaRegistry as bH, type SerializedEvalDataset as bI, type ServerComparisonOptions as bJ, type ServerComparisonResult as bK, SnapshotSanitizers as bL, type StdioMCPConfig as bM, type StoredArtifactKind as bN, type StoredArtifactSummary as bO, type StoredClientInfo as bP, type StoredEvalArtifact as bQ, type StoredEvalArtifactMetadata as bR, type StoredEvalResultLoadOptions as bS, type StoredEvalResultRef as bT, type StoredEvalResultSaveOptions as bU, type StoredEvalRunRef as bV, type StoredOAuthState as bW, type StoredServerMetadata as bX, type StoredTokens as bY, type TaggedConfig as bZ, type TokenResult as b_, MCPConfigSchema as ba, type MCPConformanceCheck as bb, type MCPConformanceOptions as bc, type MCPConformanceRaw as bd, type MCPConformanceResult as be, type MCPConformanceResultData as bf, type MCPEvalData as bg, type MCPEvalHistoricalSummary as bh, type MCPEvalReporterConfig as bi, type MCPEvalRunData as bj, type MCPFixtureOptions as bk, type MCPHostCapabilities as bl, type MCPHostSimulator as bm, type MCPOAuthConfig as bn, type MCPServerCapabilitiesData as bo, MCP_PROTOCOL_VERSION as bp, type MetricKind as bq, type NormalizedToolResponse as br, type ObservationConfidence as bs, PlaywrightOAuthClientProvider as bt, type PlaywrightOAuthClientProviderConfig as bu, type PredicateResult as bv, type ProposeVariantsContext as bw, type ProtectedResourceDiscoveryResult as bx, type ProtectedResourceMetadata as by, type ProviderKind as bz, type SizeValidatorOptions as c, type ToolOverrideVariant as c0, type TraceSource as c1, type UsageMetrics as c2, type VariantCandidateResult as c3, type VariantExperimentOptions as c4, type VariantExperimentReason as c5, type VariantExperimentResult as c6, type VariantExperimentRound as c7, type VariantImprovementProposal as c8, type VariantRecommendation as c9, normalizeToolResponse as cA, performClientCredentialsFlow as cB, refreshAccessToken as cC, registerJudge as cD, resolveDatasetPaths as cE, resolveEvalResultStore as cF, resolveRubric as cG, runConformanceChecks as cH, runEvalCase as cI, runEvalDataset as cJ, runServerComparison as cK, runVariantExperiment as cL, saveBaseline as cM, saveEvalRunComparison as cN, saveServerComparison as cO, validateEvalCase as cP, validateEvalDataset as cQ, validateJudge as cR, validateMCPConfig as cS, validateToolCallCount as cT, validateToolCalls as cU, closeMCPClient as ca, compareEvalRuns as cb, createDefaultArtifactId as cc, createEvalResultStore as cd, createMCPClientForConfig as ce, createMCPFixture as cf, createStoredEvalArtifact as cg, defaultEnvironmentMetadata as ch, discoverAuthorizationServer as ci, discoverProtectedResource as cj, extractText as ck, hasValidTokens as cl, injectTokens as cm, isBuiltInRubric as cn, isEvalResultStore as co, isHttpConfig as cp, isStdioConfig as cq, loadBaseline as cr, loadEvalDataset as cs, loadEvalDatasetFromObject as ct, loadEvalManifest as cu, loadEvalManifestFromObject as cv, loadStoredEvalRunnerResult as cw, loadTokens as cx, loadTokensFromEnv as cy, test as cz, type SnapshotSanitizer as d, type ToolPredicate as e, type ToolCallExpectation as f, type ToolCallCountOptions as g, type JudgeDefinition as h, type MetricDefinition as i, type ResultStoreDefinition as j, type EvalManifest as k, type EvalCaseResult as l, type MetricValue as m, type ResolvedMetric as n, type EvalDataset as o, type MCPConfig as p, type DatasetConfig as q, type EvalRunnerResult as r, type EvaluationSummary as s, type EvaluationBatchItem as t, type EvaluationBatchOptions as u, type EvaluationBatchResult as v, type ExternalHostConfig as w, type ExternalHostRunResult as x, type ExternalHostCapabilityImplementation as y, type HostDriverId as z };
|