@evolvingmachines/evolve 0.0.65 → 0.0.66
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/{chunk-DK2MGUPB.js → chunk-RFLMRPGK.js} +5 -5
- package/dist/cli/index.cjs +39 -39
- package/dist/cli/index.d.cts +3 -3
- package/dist/cli/index.d.ts +3 -3
- package/dist/cli/index.js +30 -30
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.js +1 -1
- package/dist/{types-B_qmzlMk.d.cts → types-84M4J_Vm.d.cts} +11 -44
- package/dist/{types-B_qmzlMk.d.ts → types-84M4J_Vm.d.ts} +11 -44
- package/package.json +4 -4
- package/skills/create-adapter/SKILL.md +71 -26
- package/skills/create-task/SKILL.md +124 -66
- package/skills/evolve/SKILL.md +37 -20
- package/skills/evolve-evals/SKILL.md +142 -69
- package/skills/evolve-evals/references/cli-reference/agent.md +76 -0
- package/skills/evolve-evals/references/cli-reference/analysis.md +78 -0
- package/skills/evolve-evals/references/cli-reference/analyze.md +95 -0
- package/skills/evolve-evals/references/cli-reference/auth.md +96 -0
- package/skills/evolve-evals/references/cli-reference/check.md +156 -0
- package/skills/evolve-evals/references/cli-reference/dataset.md +154 -0
- package/skills/evolve-evals/references/cli-reference/filesystem.md +168 -0
- package/skills/evolve-evals/references/cli-reference/index.md +149 -0
- package/skills/evolve-evals/references/cli-reference/job.md +198 -0
- package/skills/evolve-evals/references/cli-reference/run.md +187 -0
- package/skills/evolve-evals/references/cli-reference/secrets.md +77 -0
- package/skills/evolve-evals/references/cli-reference/session.md +56 -0
- package/skills/evolve-evals/references/cli-reference/skill.md +52 -0
- package/skills/evolve-evals/references/cli-reference/skills.md +85 -0
- package/skills/evolve-evals/references/cli-reference/trial.md +115 -0
- package/skills/evolve-evals/references/cli-reference/upload.md +72 -0
- package/skills/evolve-evals/references/core-concepts/agents.md +96 -0
- package/skills/evolve-evals/references/core-concepts/analyze.md +143 -0
- package/skills/evolve-evals/references/core-concepts/check.md +116 -0
- package/skills/evolve-evals/references/core-concepts/compatibility.md +39 -0
- package/skills/evolve-evals/references/core-concepts/compose.md +103 -0
- package/skills/evolve-evals/references/core-concepts/datasets.md +234 -0
- package/skills/evolve-evals/references/core-concepts/index.md +52 -0
- package/skills/evolve-evals/references/core-concepts/jobs.md +223 -0
- package/skills/evolve-evals/references/core-concepts/models.md +73 -0
- package/skills/evolve-evals/references/core-concepts/multi-step.md +93 -0
- package/skills/evolve-evals/references/core-concepts/rewardkit.md +341 -0
- package/skills/evolve-evals/references/core-concepts/sandboxes.md +73 -0
- package/skills/evolve-evals/references/core-concepts/secrets.md +86 -0
- package/skills/evolve-evals/references/core-concepts/sharing.md +81 -0
- package/skills/evolve-evals/references/core-concepts/skills.md +100 -0
- package/skills/evolve-evals/references/core-concepts/task-config.md +169 -0
- package/skills/evolve-evals/references/core-concepts/task-environment.md +127 -0
- package/skills/evolve-evals/references/core-concepts/task-reference.md +191 -0
- package/skills/evolve-evals/references/core-concepts/task-verifiers.md +209 -0
- package/skills/evolve-evals/references/core-concepts/tasks.md +90 -0
- package/skills/evolve-evals/references/core-concepts/teams.md +128 -0
- package/skills/evolve-evals/references/core-concepts/trial-outputs.md +225 -0
- package/skills/evolve-evals/references/core-concepts/trials.md +129 -0
- package/skills/evolve-evals/references/core-concepts/upload-sdk-session.md +240 -0
- package/skills/evolve-evals/references/core-concepts/upload.md +166 -0
- package/skills/evolve-evals/references/dashboard/checks.md +54 -0
- package/skills/evolve-evals/references/dashboard/datasets.md +65 -0
- package/skills/evolve-evals/references/dashboard/jobs.md +106 -0
- package/skills/evolve-evals/references/dashboard/traces.md +54 -0
- package/skills/evolve-evals/references/dashboard/trial-viewer.md +77 -0
- package/skills/evolve-evals/references/getting-started/first-task.md +228 -0
- package/skills/evolve-evals/references/getting-started/installation.md +79 -0
- package/skills/evolve-evals/references/getting-started/quick-start.md +100 -0
- package/skills/evolve-evals/references/index.md +58 -0
- package/skills/evolve-evals/references/sdk/http.md +110 -0
- package/skills/evolve-evals/references/sdk/python.md +108 -0
- package/skills/evolve-evals/references/sdk/typescript.md +104 -0
- package/skills/evolve-evals/references/sdk-reference/agents.md +75 -0
- package/skills/evolve-evals/references/sdk-reference/analyses.md +124 -0
- package/skills/evolve-evals/references/sdk-reference/auth.md +171 -0
- package/skills/evolve-evals/references/sdk-reference/checks.md +145 -0
- package/skills/evolve-evals/references/sdk-reference/datasets.md +170 -0
- package/skills/evolve-evals/references/sdk-reference/error-codes.md +231 -0
- package/skills/evolve-evals/references/sdk-reference/errors.md +98 -0
- package/skills/evolve-evals/references/sdk-reference/filesystem.md +166 -0
- package/skills/evolve-evals/references/sdk-reference/index.md +161 -0
- package/skills/evolve-evals/references/sdk-reference/jobs.md +250 -0
- package/skills/evolve-evals/references/sdk-reference/meta.md +54 -0
- package/skills/evolve-evals/references/sdk-reference/methods/agents.md +154 -0
- package/skills/evolve-evals/references/sdk-reference/methods/analyses.md +211 -0
- package/skills/evolve-evals/references/sdk-reference/methods/auth.md +257 -0
- package/skills/evolve-evals/references/sdk-reference/methods/checks.md +460 -0
- package/skills/evolve-evals/references/sdk-reference/methods/datasets.md +687 -0
- package/skills/evolve-evals/references/sdk-reference/methods/filesystem.md +527 -0
- package/skills/evolve-evals/references/sdk-reference/methods/jobs.md +1021 -0
- package/skills/evolve-evals/references/sdk-reference/methods/meta.md +209 -0
- package/skills/evolve-evals/references/sdk-reference/methods/secrets.md +157 -0
- package/skills/evolve-evals/references/sdk-reference/methods/skills.md +125 -0
- package/skills/evolve-evals/references/sdk-reference/methods/trials.md +371 -0
- package/skills/evolve-evals/references/sdk-reference/secrets.md +104 -0
- package/skills/evolve-evals/references/sdk-reference/skills.md +66 -0
- package/skills/evolve-evals/references/sdk-reference/trials.md +164 -0
- package/skills/evolve-evals/references/sdk-reference/types.md +1249 -0
- package/skills/publish/SKILL.md +103 -79
- package/skills/rewardkit/SKILL.md +78 -23
- package/spec/openapi.yaml +19 -74
- package/skills/evolve-evals/references/cli-reference/agent.mdx +0 -79
- package/skills/evolve-evals/references/cli-reference/analysis.mdx +0 -160
- package/skills/evolve-evals/references/cli-reference/analyze.mdx +0 -84
- package/skills/evolve-evals/references/cli-reference/auth.mdx +0 -133
- package/skills/evolve-evals/references/cli-reference/check.mdx +0 -263
- package/skills/evolve-evals/references/cli-reference/dataset.mdx +0 -151
- package/skills/evolve-evals/references/cli-reference/index.mdx +0 -108
- package/skills/evolve-evals/references/cli-reference/job.mdx +0 -278
- package/skills/evolve-evals/references/cli-reference/run.mdx +0 -204
- package/skills/evolve-evals/references/cli-reference/secrets.mdx +0 -95
- package/skills/evolve-evals/references/cli-reference/skill.mdx +0 -61
- package/skills/evolve-evals/references/cli-reference/skills.mdx +0 -81
- package/skills/evolve-evals/references/cli-reference/trial.mdx +0 -181
- package/skills/evolve-evals/references/cli-reference/upload.mdx +0 -36
- package/skills/evolve-evals/references/core-concepts/agents.mdx +0 -106
- package/skills/evolve-evals/references/core-concepts/analyze.mdx +0 -86
- package/skills/evolve-evals/references/core-concepts/check.mdx +0 -64
- package/skills/evolve-evals/references/core-concepts/datasets.mdx +0 -138
- package/skills/evolve-evals/references/core-concepts/index.mdx +0 -42
- package/skills/evolve-evals/references/core-concepts/jobs.mdx +0 -151
- package/skills/evolve-evals/references/core-concepts/models.mdx +0 -68
- package/skills/evolve-evals/references/core-concepts/sandboxes.mdx +0 -52
- package/skills/evolve-evals/references/core-concepts/secrets.mdx +0 -41
- package/skills/evolve-evals/references/core-concepts/sharing.mdx +0 -35
- package/skills/evolve-evals/references/core-concepts/skills.mdx +0 -42
- package/skills/evolve-evals/references/core-concepts/tasks.mdx +0 -216
- package/skills/evolve-evals/references/core-concepts/teams.mdx +0 -36
- package/skills/evolve-evals/references/core-concepts/trial-outputs.mdx +0 -117
- package/skills/evolve-evals/references/core-concepts/trials.mdx +0 -103
- package/skills/evolve-evals/references/core-concepts/upload.mdx +0 -93
- package/skills/evolve-evals/references/dashboard/checks.mdx +0 -21
- package/skills/evolve-evals/references/dashboard/datasets.mdx +0 -24
- package/skills/evolve-evals/references/dashboard/jobs.mdx +0 -65
- package/skills/evolve-evals/references/dashboard/traces.mdx +0 -17
- package/skills/evolve-evals/references/dashboard/trial-viewer.mdx +0 -30
- package/skills/evolve-evals/references/getting-started/installation.mdx +0 -56
- package/skills/evolve-evals/references/getting-started/quick-start.mdx +0 -94
- package/skills/evolve-evals/references/index.mdx +0 -48
- package/skills/evolve-evals/references/sdk/python.mdx +0 -161
- package/skills/evolve-evals/references/sdk/typescript.mdx +0 -163
- package/skills/evolve-evals/references/sdk-reference/agents.mdx +0 -108
- package/skills/evolve-evals/references/sdk-reference/analyses.mdx +0 -222
- package/skills/evolve-evals/references/sdk-reference/auth.mdx +0 -116
- package/skills/evolve-evals/references/sdk-reference/checks.mdx +0 -300
- package/skills/evolve-evals/references/sdk-reference/datasets.mdx +0 -346
- package/skills/evolve-evals/references/sdk-reference/errors.mdx +0 -210
- package/skills/evolve-evals/references/sdk-reference/index.mdx +0 -60
- package/skills/evolve-evals/references/sdk-reference/jobs.mdx +0 -822
- package/skills/evolve-evals/references/sdk-reference/meta.mdx +0 -52
- package/skills/evolve-evals/references/sdk-reference/skills.mdx +0 -69
- package/skills/evolve-evals/references/sdk-reference/trials.mdx +0 -302
- package/skills/evolve-evals/references/sdk-reference/types.mdx +0 -274
- package/skills/evolve-evals/references/snippets/global-options.mdx +0 -13
- package/skills/evolve-evals/references/snippets/list-flags.mdx +0 -23
|
@@ -419,7 +419,7 @@ interface RetryConfig {
|
|
|
419
419
|
interface RubricCriterion {
|
|
420
420
|
/**
|
|
421
421
|
* Criterion identifier, snake_case (it keys the result's `checks` object).
|
|
422
|
-
* The platform's default rubrics
|
|
422
|
+
* The platform's default rubrics are served by `analyses().defaults()` and `checks().defaults()`.
|
|
423
423
|
*/
|
|
424
424
|
name: string;
|
|
425
425
|
/** What the criterion evaluates, one sentence. */
|
|
@@ -448,8 +448,7 @@ interface Rubric {
|
|
|
448
448
|
* as the body of `POST /api/jobs/{jobId}/analyze` it configures that manual
|
|
449
449
|
* wave. `{}` is legal and means "all defaults":
|
|
450
450
|
* openrouter/deepseek/deepseek-v4.1-flash at its per-model effort (high)
|
|
451
|
-
* over the platform's default analyze rubric
|
|
452
|
-
* first) and its default prompt body.
|
|
451
|
+
* over the platform's default analyze rubric and its default prompt body.
|
|
453
452
|
*
|
|
454
453
|
* The analyzer always runs the claude-code harness (Harbor's default analyze
|
|
455
454
|
* agent) in its own sealed sandbox — on the provider `sandbox_provider`
|
|
@@ -1472,24 +1471,6 @@ interface AnalysisCheck {
|
|
|
1472
1471
|
explanation: string;
|
|
1473
1472
|
evidence: AnalysisEvidence[];
|
|
1474
1473
|
}
|
|
1475
|
-
/**
|
|
1476
|
-
* The derived label of an analysis — computed by the platform from the
|
|
1477
|
-
* outcomes when the result is stored, never asked from the model. Null until
|
|
1478
|
-
* completed, and null on a completed analysis whose rubric is not the
|
|
1479
|
-
* default one (a custom rubric carries its per-criterion outcomes and no
|
|
1480
|
-
* label). Precedence: `flagged` on a fail of score_is_earned,
|
|
1481
|
-
* score_is_correct, task_was_fair or report_is_truthful; else `env_fault` on
|
|
1482
|
-
* a fail of environment_worked; else `unclear` on an unknown of any of those
|
|
1483
|
-
* five, or a not_applicable of score_is_earned or score_is_correct; else
|
|
1484
|
-
* `clean`.
|
|
1485
|
-
*/
|
|
1486
|
-
type AnalysisLabel = "flagged" | "env_fault" | "unclear" | "clean";
|
|
1487
|
-
/**
|
|
1488
|
-
* The derived label of a task check — computed the same way. `has_a_problem`
|
|
1489
|
-
* on a fail of any criterion; else `unclear` on an unknown of any of the six
|
|
1490
|
-
* file-based criteria; else `no_problem_found`. Null under a custom rubric.
|
|
1491
|
-
*/
|
|
1492
|
-
type CheckLabel = "has_a_problem" | "unclear" | "no_problem_found";
|
|
1493
1474
|
/**
|
|
1494
1475
|
* Why an analysis FAILED — a stored typed failure, never a silent absence and
|
|
1495
1476
|
* never a fake pass. NOT under the key `error` for the same reason JobFailure
|
|
@@ -1531,7 +1512,7 @@ interface TrialAnalysis {
|
|
|
1531
1512
|
* Provenance: the analyzed trial, its job, and its task. Redundant on
|
|
1532
1513
|
* `Trial.analysis` (the trial is the enclosing object) and the whole point
|
|
1533
1514
|
* of a `analyses().list()` row, where nothing else says which run the
|
|
1534
|
-
*
|
|
1515
|
+
* result judged. Harbor's `trial_name` names the same thing by directory.
|
|
1535
1516
|
*/
|
|
1536
1517
|
trial_id: string;
|
|
1537
1518
|
job_id: string;
|
|
@@ -1565,8 +1546,6 @@ interface TrialAnalysis {
|
|
|
1565
1546
|
* (the frozen-criteria law). Null until completed.
|
|
1566
1547
|
*/
|
|
1567
1548
|
checks: Record<string, AnalysisCheck> | null;
|
|
1568
|
-
/** The derived label (AnalysisLabel states the rule); null until completed, and null under a custom rubric. */
|
|
1569
|
-
label: AnalysisLabel | null;
|
|
1570
1549
|
estimated_cost_usd: number | null;
|
|
1571
1550
|
/**
|
|
1572
1551
|
* The analyzer's one-home usage reading — the SAME object, same keys, the
|
|
@@ -4536,7 +4515,7 @@ interface AnalysisTranscript {
|
|
|
4536
4515
|
stored_at?: string[];
|
|
4537
4516
|
}
|
|
4538
4517
|
/**
|
|
4539
|
-
* Client for analysis runs — the analyzer's own transcript,
|
|
4518
|
+
* Client for analysis runs — the analyzer's own transcript, result document,
|
|
4540
4519
|
* and stored artifacts, all globally addressable by analysis id.
|
|
4541
4520
|
*
|
|
4542
4521
|
* DELIBERATELY OFF-CONTRACT: these three reads ride the dashboard's traces
|
|
@@ -4551,7 +4530,7 @@ interface AnalysisTranscript {
|
|
|
4551
4530
|
* GatewayUsageEvent prose, not as an operation. RECORDED TENSION: whether
|
|
4552
4531
|
* that feed and this one join the contract as operations (spec + both SDK
|
|
4553
4532
|
* shadows) is an open ruling, not something settled here. The contract-side
|
|
4554
|
-
*
|
|
4533
|
+
* result stays where it always was — `Trial.analysis` on the trial body;
|
|
4555
4534
|
* this client adds the reads the contract does not carry today.
|
|
4556
4535
|
*/
|
|
4557
4536
|
interface AnalysesClient {
|
|
@@ -4572,7 +4551,7 @@ interface AnalysesClient {
|
|
|
4572
4551
|
/** The defaults an analysis runs under when its config names nothing (GET /api/analyses/defaults): model, effort, provider, rubric and the unrendered prompt template. */
|
|
4573
4552
|
defaults(): Promise<AnalyzeDefaults>;
|
|
4574
4553
|
/**
|
|
4575
|
-
* The
|
|
4554
|
+
* The result document — the wire's TrialAnalysis, statuses and typed
|
|
4576
4555
|
* failure included, for EVERY analysis (not only completed ones). The same
|
|
4577
4556
|
* object the analyzed trial serves as `Trial.analysis` when this analysis
|
|
4578
4557
|
* is its latest; this door answers for earlier analyses too.
|
|
@@ -4636,7 +4615,7 @@ interface AnalysesClient {
|
|
|
4636
4615
|
* analyzer's `openrouter/deepseek/deepseek-v4.1-flash` — one roster, one
|
|
4637
4616
|
* default for both rubric
|
|
4638
4617
|
* agents, a recorded deviation), `rubric` (the default is the platform's
|
|
4639
|
-
* check rubric
|
|
4618
|
+
* check rubric), and
|
|
4640
4619
|
* `prompt` (the TEXT of Harbor's `-p/--prompt` file, replacing the platform's
|
|
4641
4620
|
* default check body and rendered with `{task_path}`, `{file_tree}`,
|
|
4642
4621
|
* `{criteria_guidance}`; the output contract is appended after it exactly
|
|
@@ -4658,7 +4637,7 @@ interface CheckConfigInput {
|
|
|
4658
4637
|
name?: string;
|
|
4659
4638
|
/** Model the checker agent runs (Harbor's `-m/--model`); must be on the claude roster (`GET /api/meta`). */
|
|
4660
4639
|
model_name?: string;
|
|
4661
|
-
/** The rubric (Harbor's `-r/--rubric` file as its `{criteria}` object); default: the platform's check rubric (
|
|
4640
|
+
/** The rubric (Harbor's `-r/--rubric` file as its `{criteria}` object); default: the platform's check rubric (`checks().defaults()`). */
|
|
4662
4641
|
rubric?: Rubric;
|
|
4663
4642
|
/** The prompt template — the TEXT of Harbor's `-p/--prompt` file. */
|
|
4664
4643
|
prompt?: string;
|
|
@@ -4719,9 +4698,8 @@ interface CheckSource {
|
|
|
4719
4698
|
/**
|
|
4720
4699
|
* One task's quality check — Harbor's QualityCheckResult shape (their
|
|
4721
4700
|
* cli/quality_checker/models.py:31-35: `task_name`, `checks` keyed by
|
|
4722
|
-
* criterion, `cost_usd`), its checks extended by the result schema
|
|
4723
|
-
*
|
|
4724
|
-
* it belongs to, its lifecycle (the analysis ladder's four lowercase words),
|
|
4701
|
+
* criterion, `cost_usd`), its checks extended by the result schema, plus the
|
|
4702
|
+
* hosted provenance: its own id, the check it belongs to, its lifecycle (the analysis ladder's four lowercase words),
|
|
4725
4703
|
* the bounded attempt count, and a typed `failure` in place of Harbor's
|
|
4726
4704
|
* `error` string (the TrialAnalysis rule).
|
|
4727
4705
|
*
|
|
@@ -4740,17 +4718,6 @@ interface TaskCheck {
|
|
|
4740
4718
|
status: AnalysisStatus;
|
|
4741
4719
|
/** One entry per rubric criterion, keys exactly the frozen criteria. Null until completed. */
|
|
4742
4720
|
checks: Record<string, AnalysisCheck> | null;
|
|
4743
|
-
/** The derived label (CheckLabel states the rule); null until completed, and null under a custom rubric. */
|
|
4744
|
-
label: CheckLabel | null;
|
|
4745
|
-
/**
|
|
4746
|
-
* Whether the box ran the task's environment: true when none of the five
|
|
4747
|
-
* run-based criteria (reference_solution_is_valid,
|
|
4748
|
-
* verifier_rejects_non_solutions, environment_builds_and_runs,
|
|
4749
|
-
* verification_is_stable, limits_allow_the_task) is unknown, so a
|
|
4750
|
-
* reading-only `no_problem_found` is never mistaken for a run. Null
|
|
4751
|
-
* exactly when `label` is null.
|
|
4752
|
-
*/
|
|
4753
|
-
executed: boolean | null;
|
|
4754
4721
|
cost_usd: number | null;
|
|
4755
4722
|
/** 1, or 2 when the one automatic re-run fired (a run that produced no valid check-result.json, the missing file included, is re-run once — the analyze verb's hosted rule; a run cut by its budget is not that class: it settles `failed` with phase `timeout` at once and is never re-run). */
|
|
4756
4723
|
attempts: number;
|
|
@@ -5408,4 +5375,4 @@ interface CapabilityDocument {
|
|
|
5408
5375
|
error_codes: string[];
|
|
5409
5376
|
}
|
|
5410
5377
|
|
|
5411
|
-
export { type AnalysisEvidence as $, type AgentInput as A, type AgentArm as B, type Check as C, type DatasetVersion as D, type AgentArmInput as E, type AgentCapability as F, type GatewayUsageEvent as G, type HostedErrorCode as H, type AgentDatasetStats as I, type JobCreate as J, type AgentEffortSupport as K, type AgentInfo as L, type AgentList as M, type AgentModelOption as N, type OrgsClient as O, type PublishDatasetInput as P, type AgentPage as Q, type Rubric as R, type SkillsClient as S, type Trial as T, type UsageReading as U, type AgentResult as V, type AgentSource as W, type AgentSourceInput as X, type AgentUpsertInput as Y, type AnalysisArtifactStream as Z, type AnalysisCheck as _, type TrialAnalysis as a, type
|
|
5378
|
+
export { type AnalysisEvidence as $, type AgentInput as A, type AgentArm as B, type Check as C, type DatasetVersion as D, type AgentArmInput as E, type AgentCapability as F, type GatewayUsageEvent as G, type HostedErrorCode as H, type AgentDatasetStats as I, type JobCreate as J, type AgentEffortSupport as K, type AgentInfo as L, type AgentList as M, type AgentModelOption as N, type OrgsClient as O, type PublishDatasetInput as P, type AgentPage as Q, type Rubric as R, type SkillsClient as S, type Trial as T, type UsageReading as U, type AgentResult as V, type AgentSource as W, type AgentSourceInput as X, type AgentUpsertInput as Y, type AnalysisArtifactStream as Z, type AnalysisCheck as _, type TrialAnalysis as a, type FilesystemSource as a$, type AnalysisFailure as a0, type AnalysisList as a1, type AnalysisPage as a2, type AnalysisStatus as a3, type AnalysisTranscript as a4, type AnalysisTranscriptOptions as a5, type AnalyzeConfig as a6, type AnalyzeConfigInput as a7, type AnalyzeDefaults as a8, type ApiKey as a9, type DatasetVersionArchiveSource as aA, type DatasetVersionArchiveUrlSource as aB, type DatasetVersionGitSource as aC, type DatasetVersionHubSource as aD, type DatasetVersionSource as aE, type DatasetVersionState as aF, type DownloadDatasetOptions as aG, type DownloadJobOptions as aH, EVAL_SANDBOX_PROVIDERS as aI, type Agent as aJ, type ModelInfo as aK, type EvalSandboxProvider as aL, type StepResult as aM, type ExceptionInfo as aN, type FilesystemArchiveOptions as aO, type FilesystemBox as aP, type FilesystemCapture as aQ, type FilesystemChange as aR, type FilesystemChanges as aS, type FilesystemChangesOptions as aT, type FilesystemEntry as aU, type FilesystemListOptions as aV, type FilesystemListing as aW, type FilesystemReadOptions as aX, type FilesystemSearchHit as aY, type FilesystemSearchOptions as aZ, type FilesystemSearchResult as a_, type AttemptPhase as aa, type AuthStatus as ab, type Awaitable as ac, CHECK_STATUSES as ad, type CheckDefaults as ae, type CheckRow as af, type CheckRowList as ag, type CheckRowPage as ah, type CheckTaskTally as ai, type CompareCell as aj, type CompareCoverage as ak, type CompareJobAggregate as al, type CompareResponse as am, type CompareTaskRow as an, type Dataset as ao, type DatasetImportFailure as ap, type DatasetImportList as aq, type DatasetImportPage as ar, type DatasetImportStatus as as, type DatasetList as at, type DatasetPage as au, type DatasetPatch as av, type DatasetPreflight as aw, type DatasetRef as ax, type DatasetSelector as ay, type DatasetSource as az, type DatasetImport as b, type OrgQuota as b$, type FilesystemState as b0, type FilesystemStatus as b1, type FilesystemStreamEvent as b2, type FilesystemStreamOptions as b3, type FilesystemWatchResult as b4, GATEWAY_TRACE_SEQ_BASE as b5, type GatewayUsage as b6, type GetDatasetOptions as b7, type GrepJobOptions as b8, HOSTED_ERROR_CODES as b9, type JobPage as bA, type JobShareEmail as bB, type JobShareLink as bC, type JobStats as bD, type JobStatus as bE, type JobTaskLink as bF, type JobTaskRollup as bG, type JobTaskRollupList as bH, type JobTaskRollupPage as bI, type JobViewer as bJ, type JobWatch as bK, type JudgeResult as bL, type ListAgentsOptions as bM, type ListAnalysesOptions as bN, type ListDatasetsOptions as bO, type ListImportsOptions as bP, type ListJobImportsOptions as bQ, type ListJobTasksOptions as bR, type ListJobsOptions as bS, type ListSkillsOptions as bT, type ListTrialFilesOptions as bU, type ListTrialsOptions as bV, type ManagedProviderCapability as bW, type OrgInvite as bX, type OrgInviteCreated as bY, type OrgJoined as bZ, type OrgMember as b_, type ImportPhase as ba, type ImportPhaseProgress as bb, type ImportWarning as bc, type InfraFailureSignature as bd, JOB_LIST_KINDS as be, JOB_LIST_SCOPES as bf, type JobAnalysisStats as bg, type JobDeleteResult as bh, type JobFailure as bi, type JobGrepGroup as bj, type JobGrepPage as bk, type JobImport as bl, type JobImportFailure as bm, type JobImportList as bn, type JobImportPage as bo, type JobImportPhaseName as bp, type JobImportPhaseProgress as bq, type JobImportProgress as br, type JobImportSkippedTrial as bs, type JobImportSource as bt, type JobList as bu, type JobListItem as bv, type JobListItemList as bw, type JobListItemPage as bx, type JobListKind as by, type JobListScope as bz, type JobEvent as c, type UploadProvenance as c$, type OrgRole as c0, type OrgUsage as c1, type Organization as c2, type OrganizationDetail as c3, type Page as c4, type PageOptions as c5, type PassAtKGroup as c6, type PassAtKPoint as c7, type PreflightDatasetInput as c8, type PreflightDeferredCheck as c9, TASK_LINK_REASONS as cA, TRIAL_ARTIFACT_STREAMS as cB, TRIAL_STATUSES as cC, type Task as cD, type TaskCheckTranscript as cE, type TaskLinkReason as cF, type TaskLinkedBy as cG, type TaskNote as cH, type TaskPackageFiles as cI, type TaskPackageFilesystemStatus as cJ, type TaskProviderVerdict as cK, type TimingInfo as cL, type TraceEventPage as cM, type TraceOptions as cN, type TrialArtifactStream as cO, type TrialCounts as cP, type TrialFile as cQ, type TrialFilePage as cR, type TrialFileRange as cS, type TrialGpuCost as cT, type TrialList as cU, type TrialPage as cV, type TrialStatus as cW, type TrialStatusTally as cX, type TrialTaskLink as cY, type TrialUploadProvenance as cZ, type UploadJobOptions as c_, type PreflightManifestVerdict as ca, type PreflightTaskVerdict as cb, type ProviderCapability as cc, type PublishDatasetOptions as cd, type RegradeRequest as ce, type ResumeRequest as cf, type RetryRequest as cg, type RubricCriterion as ch, type RunFilesystem as ci, SANDBOX_LOG_STREAMS as cj, type SandboxLogEvent as ck, type SandboxLogLine as cl, type SandboxLogLines as cm, type SandboxLogOptions as cn, type SandboxLogStream as co, type SandboxProcs as cp, type SkillLock as cq, type SkillUpload as cr, type SkillUploadList as cs, type SkillUploadPage as ct, type SourceJob as cu, type SpendSource as cv, type StartJobOptions as cw, type StatusVocabulary as cx, type StopResponse as cy, TASK_LINKED_BY as cz, type DatasetFailedTask as d, type UploadSkillOptions as d0, type UpstreamStatus as d1, type VerifierEnvironmentMode as d2, type VerifierResult as d3, type WatchAnalysisOptions as d4, type WatchImportOptions as d5, type WatchJobImportOptions as d6, type WatchJobOptions as d7, gatewayUsageOf as d8, isHostedErrorCode as d9, passAtK as da, type DatasetImportProgress as e, type JobSecretInline as f, type JobSecretRef as g, type TraceEvent as h, type JobVisibility as i, type JobShareRequest as j, type JobShares as k, type Job as l, type TaskCheck as m, type DatasetsClient as n, type AgentsClient as o, type JobsClient as p, type TrialsClient as q, type AnalysesClient as r, type ChecksClient as s, type CapabilityDocument as t, type HostedClientConfig as u, type AuthClient as v, AGENT_EFFORT_SUPPORT_VALUES as w, ANALYSIS_ARTIFACT_STREAMS as x, ANALYSIS_STATUSES as y, type ActiveDataset as z };
|
|
@@ -419,7 +419,7 @@ interface RetryConfig {
|
|
|
419
419
|
interface RubricCriterion {
|
|
420
420
|
/**
|
|
421
421
|
* Criterion identifier, snake_case (it keys the result's `checks` object).
|
|
422
|
-
* The platform's default rubrics
|
|
422
|
+
* The platform's default rubrics are served by `analyses().defaults()` and `checks().defaults()`.
|
|
423
423
|
*/
|
|
424
424
|
name: string;
|
|
425
425
|
/** What the criterion evaluates, one sentence. */
|
|
@@ -448,8 +448,7 @@ interface Rubric {
|
|
|
448
448
|
* as the body of `POST /api/jobs/{jobId}/analyze` it configures that manual
|
|
449
449
|
* wave. `{}` is legal and means "all defaults":
|
|
450
450
|
* openrouter/deepseek/deepseek-v4.1-flash at its per-model effort (high)
|
|
451
|
-
* over the platform's default analyze rubric
|
|
452
|
-
* first) and its default prompt body.
|
|
451
|
+
* over the platform's default analyze rubric and its default prompt body.
|
|
453
452
|
*
|
|
454
453
|
* The analyzer always runs the claude-code harness (Harbor's default analyze
|
|
455
454
|
* agent) in its own sealed sandbox — on the provider `sandbox_provider`
|
|
@@ -1472,24 +1471,6 @@ interface AnalysisCheck {
|
|
|
1472
1471
|
explanation: string;
|
|
1473
1472
|
evidence: AnalysisEvidence[];
|
|
1474
1473
|
}
|
|
1475
|
-
/**
|
|
1476
|
-
* The derived label of an analysis — computed by the platform from the
|
|
1477
|
-
* outcomes when the result is stored, never asked from the model. Null until
|
|
1478
|
-
* completed, and null on a completed analysis whose rubric is not the
|
|
1479
|
-
* default one (a custom rubric carries its per-criterion outcomes and no
|
|
1480
|
-
* label). Precedence: `flagged` on a fail of score_is_earned,
|
|
1481
|
-
* score_is_correct, task_was_fair or report_is_truthful; else `env_fault` on
|
|
1482
|
-
* a fail of environment_worked; else `unclear` on an unknown of any of those
|
|
1483
|
-
* five, or a not_applicable of score_is_earned or score_is_correct; else
|
|
1484
|
-
* `clean`.
|
|
1485
|
-
*/
|
|
1486
|
-
type AnalysisLabel = "flagged" | "env_fault" | "unclear" | "clean";
|
|
1487
|
-
/**
|
|
1488
|
-
* The derived label of a task check — computed the same way. `has_a_problem`
|
|
1489
|
-
* on a fail of any criterion; else `unclear` on an unknown of any of the six
|
|
1490
|
-
* file-based criteria; else `no_problem_found`. Null under a custom rubric.
|
|
1491
|
-
*/
|
|
1492
|
-
type CheckLabel = "has_a_problem" | "unclear" | "no_problem_found";
|
|
1493
1474
|
/**
|
|
1494
1475
|
* Why an analysis FAILED — a stored typed failure, never a silent absence and
|
|
1495
1476
|
* never a fake pass. NOT under the key `error` for the same reason JobFailure
|
|
@@ -1531,7 +1512,7 @@ interface TrialAnalysis {
|
|
|
1531
1512
|
* Provenance: the analyzed trial, its job, and its task. Redundant on
|
|
1532
1513
|
* `Trial.analysis` (the trial is the enclosing object) and the whole point
|
|
1533
1514
|
* of a `analyses().list()` row, where nothing else says which run the
|
|
1534
|
-
*
|
|
1515
|
+
* result judged. Harbor's `trial_name` names the same thing by directory.
|
|
1535
1516
|
*/
|
|
1536
1517
|
trial_id: string;
|
|
1537
1518
|
job_id: string;
|
|
@@ -1565,8 +1546,6 @@ interface TrialAnalysis {
|
|
|
1565
1546
|
* (the frozen-criteria law). Null until completed.
|
|
1566
1547
|
*/
|
|
1567
1548
|
checks: Record<string, AnalysisCheck> | null;
|
|
1568
|
-
/** The derived label (AnalysisLabel states the rule); null until completed, and null under a custom rubric. */
|
|
1569
|
-
label: AnalysisLabel | null;
|
|
1570
1549
|
estimated_cost_usd: number | null;
|
|
1571
1550
|
/**
|
|
1572
1551
|
* The analyzer's one-home usage reading — the SAME object, same keys, the
|
|
@@ -4536,7 +4515,7 @@ interface AnalysisTranscript {
|
|
|
4536
4515
|
stored_at?: string[];
|
|
4537
4516
|
}
|
|
4538
4517
|
/**
|
|
4539
|
-
* Client for analysis runs — the analyzer's own transcript,
|
|
4518
|
+
* Client for analysis runs — the analyzer's own transcript, result document,
|
|
4540
4519
|
* and stored artifacts, all globally addressable by analysis id.
|
|
4541
4520
|
*
|
|
4542
4521
|
* DELIBERATELY OFF-CONTRACT: these three reads ride the dashboard's traces
|
|
@@ -4551,7 +4530,7 @@ interface AnalysisTranscript {
|
|
|
4551
4530
|
* GatewayUsageEvent prose, not as an operation. RECORDED TENSION: whether
|
|
4552
4531
|
* that feed and this one join the contract as operations (spec + both SDK
|
|
4553
4532
|
* shadows) is an open ruling, not something settled here. The contract-side
|
|
4554
|
-
*
|
|
4533
|
+
* result stays where it always was — `Trial.analysis` on the trial body;
|
|
4555
4534
|
* this client adds the reads the contract does not carry today.
|
|
4556
4535
|
*/
|
|
4557
4536
|
interface AnalysesClient {
|
|
@@ -4572,7 +4551,7 @@ interface AnalysesClient {
|
|
|
4572
4551
|
/** The defaults an analysis runs under when its config names nothing (GET /api/analyses/defaults): model, effort, provider, rubric and the unrendered prompt template. */
|
|
4573
4552
|
defaults(): Promise<AnalyzeDefaults>;
|
|
4574
4553
|
/**
|
|
4575
|
-
* The
|
|
4554
|
+
* The result document — the wire's TrialAnalysis, statuses and typed
|
|
4576
4555
|
* failure included, for EVERY analysis (not only completed ones). The same
|
|
4577
4556
|
* object the analyzed trial serves as `Trial.analysis` when this analysis
|
|
4578
4557
|
* is its latest; this door answers for earlier analyses too.
|
|
@@ -4636,7 +4615,7 @@ interface AnalysesClient {
|
|
|
4636
4615
|
* analyzer's `openrouter/deepseek/deepseek-v4.1-flash` — one roster, one
|
|
4637
4616
|
* default for both rubric
|
|
4638
4617
|
* agents, a recorded deviation), `rubric` (the default is the platform's
|
|
4639
|
-
* check rubric
|
|
4618
|
+
* check rubric), and
|
|
4640
4619
|
* `prompt` (the TEXT of Harbor's `-p/--prompt` file, replacing the platform's
|
|
4641
4620
|
* default check body and rendered with `{task_path}`, `{file_tree}`,
|
|
4642
4621
|
* `{criteria_guidance}`; the output contract is appended after it exactly
|
|
@@ -4658,7 +4637,7 @@ interface CheckConfigInput {
|
|
|
4658
4637
|
name?: string;
|
|
4659
4638
|
/** Model the checker agent runs (Harbor's `-m/--model`); must be on the claude roster (`GET /api/meta`). */
|
|
4660
4639
|
model_name?: string;
|
|
4661
|
-
/** The rubric (Harbor's `-r/--rubric` file as its `{criteria}` object); default: the platform's check rubric (
|
|
4640
|
+
/** The rubric (Harbor's `-r/--rubric` file as its `{criteria}` object); default: the platform's check rubric (`checks().defaults()`). */
|
|
4662
4641
|
rubric?: Rubric;
|
|
4663
4642
|
/** The prompt template — the TEXT of Harbor's `-p/--prompt` file. */
|
|
4664
4643
|
prompt?: string;
|
|
@@ -4719,9 +4698,8 @@ interface CheckSource {
|
|
|
4719
4698
|
/**
|
|
4720
4699
|
* One task's quality check — Harbor's QualityCheckResult shape (their
|
|
4721
4700
|
* cli/quality_checker/models.py:31-35: `task_name`, `checks` keyed by
|
|
4722
|
-
* criterion, `cost_usd`), its checks extended by the result schema
|
|
4723
|
-
*
|
|
4724
|
-
* it belongs to, its lifecycle (the analysis ladder's four lowercase words),
|
|
4701
|
+
* criterion, `cost_usd`), its checks extended by the result schema, plus the
|
|
4702
|
+
* hosted provenance: its own id, the check it belongs to, its lifecycle (the analysis ladder's four lowercase words),
|
|
4725
4703
|
* the bounded attempt count, and a typed `failure` in place of Harbor's
|
|
4726
4704
|
* `error` string (the TrialAnalysis rule).
|
|
4727
4705
|
*
|
|
@@ -4740,17 +4718,6 @@ interface TaskCheck {
|
|
|
4740
4718
|
status: AnalysisStatus;
|
|
4741
4719
|
/** One entry per rubric criterion, keys exactly the frozen criteria. Null until completed. */
|
|
4742
4720
|
checks: Record<string, AnalysisCheck> | null;
|
|
4743
|
-
/** The derived label (CheckLabel states the rule); null until completed, and null under a custom rubric. */
|
|
4744
|
-
label: CheckLabel | null;
|
|
4745
|
-
/**
|
|
4746
|
-
* Whether the box ran the task's environment: true when none of the five
|
|
4747
|
-
* run-based criteria (reference_solution_is_valid,
|
|
4748
|
-
* verifier_rejects_non_solutions, environment_builds_and_runs,
|
|
4749
|
-
* verification_is_stable, limits_allow_the_task) is unknown, so a
|
|
4750
|
-
* reading-only `no_problem_found` is never mistaken for a run. Null
|
|
4751
|
-
* exactly when `label` is null.
|
|
4752
|
-
*/
|
|
4753
|
-
executed: boolean | null;
|
|
4754
4721
|
cost_usd: number | null;
|
|
4755
4722
|
/** 1, or 2 when the one automatic re-run fired (a run that produced no valid check-result.json, the missing file included, is re-run once — the analyze verb's hosted rule; a run cut by its budget is not that class: it settles `failed` with phase `timeout` at once and is never re-run). */
|
|
4756
4723
|
attempts: number;
|
|
@@ -5408,4 +5375,4 @@ interface CapabilityDocument {
|
|
|
5408
5375
|
error_codes: string[];
|
|
5409
5376
|
}
|
|
5410
5377
|
|
|
5411
|
-
export { type AnalysisEvidence as $, type AgentInput as A, type AgentArm as B, type Check as C, type DatasetVersion as D, type AgentArmInput as E, type AgentCapability as F, type GatewayUsageEvent as G, type HostedErrorCode as H, type AgentDatasetStats as I, type JobCreate as J, type AgentEffortSupport as K, type AgentInfo as L, type AgentList as M, type AgentModelOption as N, type OrgsClient as O, type PublishDatasetInput as P, type AgentPage as Q, type Rubric as R, type SkillsClient as S, type Trial as T, type UsageReading as U, type AgentResult as V, type AgentSource as W, type AgentSourceInput as X, type AgentUpsertInput as Y, type AnalysisArtifactStream as Z, type AnalysisCheck as _, type TrialAnalysis as a, type
|
|
5378
|
+
export { type AnalysisEvidence as $, type AgentInput as A, type AgentArm as B, type Check as C, type DatasetVersion as D, type AgentArmInput as E, type AgentCapability as F, type GatewayUsageEvent as G, type HostedErrorCode as H, type AgentDatasetStats as I, type JobCreate as J, type AgentEffortSupport as K, type AgentInfo as L, type AgentList as M, type AgentModelOption as N, type OrgsClient as O, type PublishDatasetInput as P, type AgentPage as Q, type Rubric as R, type SkillsClient as S, type Trial as T, type UsageReading as U, type AgentResult as V, type AgentSource as W, type AgentSourceInput as X, type AgentUpsertInput as Y, type AnalysisArtifactStream as Z, type AnalysisCheck as _, type TrialAnalysis as a, type FilesystemSource as a$, type AnalysisFailure as a0, type AnalysisList as a1, type AnalysisPage as a2, type AnalysisStatus as a3, type AnalysisTranscript as a4, type AnalysisTranscriptOptions as a5, type AnalyzeConfig as a6, type AnalyzeConfigInput as a7, type AnalyzeDefaults as a8, type ApiKey as a9, type DatasetVersionArchiveSource as aA, type DatasetVersionArchiveUrlSource as aB, type DatasetVersionGitSource as aC, type DatasetVersionHubSource as aD, type DatasetVersionSource as aE, type DatasetVersionState as aF, type DownloadDatasetOptions as aG, type DownloadJobOptions as aH, EVAL_SANDBOX_PROVIDERS as aI, type Agent as aJ, type ModelInfo as aK, type EvalSandboxProvider as aL, type StepResult as aM, type ExceptionInfo as aN, type FilesystemArchiveOptions as aO, type FilesystemBox as aP, type FilesystemCapture as aQ, type FilesystemChange as aR, type FilesystemChanges as aS, type FilesystemChangesOptions as aT, type FilesystemEntry as aU, type FilesystemListOptions as aV, type FilesystemListing as aW, type FilesystemReadOptions as aX, type FilesystemSearchHit as aY, type FilesystemSearchOptions as aZ, type FilesystemSearchResult as a_, type AttemptPhase as aa, type AuthStatus as ab, type Awaitable as ac, CHECK_STATUSES as ad, type CheckDefaults as ae, type CheckRow as af, type CheckRowList as ag, type CheckRowPage as ah, type CheckTaskTally as ai, type CompareCell as aj, type CompareCoverage as ak, type CompareJobAggregate as al, type CompareResponse as am, type CompareTaskRow as an, type Dataset as ao, type DatasetImportFailure as ap, type DatasetImportList as aq, type DatasetImportPage as ar, type DatasetImportStatus as as, type DatasetList as at, type DatasetPage as au, type DatasetPatch as av, type DatasetPreflight as aw, type DatasetRef as ax, type DatasetSelector as ay, type DatasetSource as az, type DatasetImport as b, type OrgQuota as b$, type FilesystemState as b0, type FilesystemStatus as b1, type FilesystemStreamEvent as b2, type FilesystemStreamOptions as b3, type FilesystemWatchResult as b4, GATEWAY_TRACE_SEQ_BASE as b5, type GatewayUsage as b6, type GetDatasetOptions as b7, type GrepJobOptions as b8, HOSTED_ERROR_CODES as b9, type JobPage as bA, type JobShareEmail as bB, type JobShareLink as bC, type JobStats as bD, type JobStatus as bE, type JobTaskLink as bF, type JobTaskRollup as bG, type JobTaskRollupList as bH, type JobTaskRollupPage as bI, type JobViewer as bJ, type JobWatch as bK, type JudgeResult as bL, type ListAgentsOptions as bM, type ListAnalysesOptions as bN, type ListDatasetsOptions as bO, type ListImportsOptions as bP, type ListJobImportsOptions as bQ, type ListJobTasksOptions as bR, type ListJobsOptions as bS, type ListSkillsOptions as bT, type ListTrialFilesOptions as bU, type ListTrialsOptions as bV, type ManagedProviderCapability as bW, type OrgInvite as bX, type OrgInviteCreated as bY, type OrgJoined as bZ, type OrgMember as b_, type ImportPhase as ba, type ImportPhaseProgress as bb, type ImportWarning as bc, type InfraFailureSignature as bd, JOB_LIST_KINDS as be, JOB_LIST_SCOPES as bf, type JobAnalysisStats as bg, type JobDeleteResult as bh, type JobFailure as bi, type JobGrepGroup as bj, type JobGrepPage as bk, type JobImport as bl, type JobImportFailure as bm, type JobImportList as bn, type JobImportPage as bo, type JobImportPhaseName as bp, type JobImportPhaseProgress as bq, type JobImportProgress as br, type JobImportSkippedTrial as bs, type JobImportSource as bt, type JobList as bu, type JobListItem as bv, type JobListItemList as bw, type JobListItemPage as bx, type JobListKind as by, type JobListScope as bz, type JobEvent as c, type UploadProvenance as c$, type OrgRole as c0, type OrgUsage as c1, type Organization as c2, type OrganizationDetail as c3, type Page as c4, type PageOptions as c5, type PassAtKGroup as c6, type PassAtKPoint as c7, type PreflightDatasetInput as c8, type PreflightDeferredCheck as c9, TASK_LINK_REASONS as cA, TRIAL_ARTIFACT_STREAMS as cB, TRIAL_STATUSES as cC, type Task as cD, type TaskCheckTranscript as cE, type TaskLinkReason as cF, type TaskLinkedBy as cG, type TaskNote as cH, type TaskPackageFiles as cI, type TaskPackageFilesystemStatus as cJ, type TaskProviderVerdict as cK, type TimingInfo as cL, type TraceEventPage as cM, type TraceOptions as cN, type TrialArtifactStream as cO, type TrialCounts as cP, type TrialFile as cQ, type TrialFilePage as cR, type TrialFileRange as cS, type TrialGpuCost as cT, type TrialList as cU, type TrialPage as cV, type TrialStatus as cW, type TrialStatusTally as cX, type TrialTaskLink as cY, type TrialUploadProvenance as cZ, type UploadJobOptions as c_, type PreflightManifestVerdict as ca, type PreflightTaskVerdict as cb, type ProviderCapability as cc, type PublishDatasetOptions as cd, type RegradeRequest as ce, type ResumeRequest as cf, type RetryRequest as cg, type RubricCriterion as ch, type RunFilesystem as ci, SANDBOX_LOG_STREAMS as cj, type SandboxLogEvent as ck, type SandboxLogLine as cl, type SandboxLogLines as cm, type SandboxLogOptions as cn, type SandboxLogStream as co, type SandboxProcs as cp, type SkillLock as cq, type SkillUpload as cr, type SkillUploadList as cs, type SkillUploadPage as ct, type SourceJob as cu, type SpendSource as cv, type StartJobOptions as cw, type StatusVocabulary as cx, type StopResponse as cy, TASK_LINKED_BY as cz, type DatasetFailedTask as d, type UploadSkillOptions as d0, type UpstreamStatus as d1, type VerifierEnvironmentMode as d2, type VerifierResult as d3, type WatchAnalysisOptions as d4, type WatchImportOptions as d5, type WatchJobImportOptions as d6, type WatchJobOptions as d7, gatewayUsageOf as d8, isHostedErrorCode as d9, passAtK as da, type DatasetImportProgress as e, type JobSecretInline as f, type JobSecretRef as g, type TraceEvent as h, type JobVisibility as i, type JobShareRequest as j, type JobShares as k, type Job as l, type TaskCheck as m, type DatasetsClient as n, type AgentsClient as o, type JobsClient as p, type TrialsClient as q, type AnalysesClient as r, type ChecksClient as s, type CapabilityDocument as t, type HostedClientConfig as u, type AuthClient as v, AGENT_EFFORT_SUPPORT_VALUES as w, ANALYSIS_ARTIFACT_STREAMS as x, ANALYSIS_STATUSES as y, type ActiveDataset as z };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@evolvingmachines/evolve",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.66",
|
|
4
4
|
"keywords": [
|
|
5
5
|
"ai",
|
|
6
6
|
"agents",
|
|
@@ -129,9 +129,9 @@
|
|
|
129
129
|
},
|
|
130
130
|
"dependencies": {
|
|
131
131
|
"@agentclientprotocol/sdk": "^0.5.1",
|
|
132
|
-
"@evolvingmachines/daytona": "0.0.
|
|
133
|
-
"@evolvingmachines/e2b": "0.0.
|
|
134
|
-
"@evolvingmachines/modal": "0.0.
|
|
132
|
+
"@evolvingmachines/daytona": "0.0.66",
|
|
133
|
+
"@evolvingmachines/e2b": "0.0.66",
|
|
134
|
+
"@evolvingmachines/modal": "0.0.66",
|
|
135
135
|
"ajv": "^8.17.1",
|
|
136
136
|
"p-map": "^7.0.2",
|
|
137
137
|
"smol-toml": "^1.7.0",
|
|
@@ -10,18 +10,27 @@ metadata:
|
|
|
10
10
|
An adapter is a small program that reads an existing benchmark and writes one task
|
|
11
11
|
directory per task, in the Harbor task format. Its output is a folder of tasks, ready for
|
|
12
12
|
`evolve dataset publish`. This skill guides the conversion; `evolve skills get create-task`
|
|
13
|
-
|
|
13
|
+
guides task authoring, and `evolve skills get publish` guides publishing. Read
|
|
14
|
+
`evolve skills get evals cli-reference/dataset` for every dataset publish option.
|
|
14
15
|
|
|
15
|
-
##
|
|
16
|
+
## References
|
|
16
17
|
|
|
17
|
-
The conversion
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
18
|
+
The conversion structure follows Harbor's adapter format. Evolve's supported task
|
|
19
|
+
options and publishing workflow are documented in its bundled references:
|
|
20
|
+
|
|
21
|
+
| Topic | Read |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| Task layout and configuration | `evolve skills get evals core-concepts/tasks` and `evolve skills get evals core-concepts/task-config` |
|
|
24
|
+
| Environments and Compose | `evolve skills get evals core-concepts/task-environment` and `evolve skills get evals core-concepts/compose` |
|
|
25
|
+
| Verifiers and rewards | `evolve skills get evals core-concepts/task-verifiers` and `evolve skills get evals core-concepts/rewardkit` |
|
|
26
|
+
| Managed support limits | `evolve skills get evals core-concepts/compatibility` |
|
|
27
|
+
|
|
28
|
+
The upstream task format is at
|
|
22
29
|
https://docs.harborframework.com/core-concepts/tasks/overview.
|
|
23
30
|
|
|
24
|
-
|
|
31
|
+
Use Evolve's references for commands and supported behavior. Upstream adapter
|
|
32
|
+
examples below can help with conversion code; Harbor's registry and pull-request
|
|
33
|
+
workflow do not apply to publishing on Evolve.
|
|
25
34
|
|
|
26
35
|
## Prerequisites
|
|
27
36
|
|
|
@@ -59,7 +68,7 @@ before proceeding.
|
|
|
59
68
|
| Adapter name | Lowercase, hyphen-separated. Must match the benchmark's common identifier (e.g., `swe-bench`, `aider-polyglot`). Becomes the dataset name on Evolve and, with dashes turned to underscores, the Python package name. |
|
|
60
69
|
| Human-readable name | Appears in the README. |
|
|
61
70
|
| Upstream repo URL | Needed for step 1 (benchmark analysis) and for the README. |
|
|
62
|
-
| Reference solutions available? |
|
|
71
|
+
| Reference solutions available? | Use them when available. Otherwise record the gap and write solutions when possible; Evolve can check tasks without them. |
|
|
63
72
|
| Subset | Adapting a subset of tasks is acceptable (e.g., only a verified split). Document every exclusion in the README. |
|
|
64
73
|
|
|
65
74
|
### 3. Write the converter
|
|
@@ -90,8 +99,10 @@ The `evolve` CLI has no adapter scaffold; create this layout by hand:
|
|
|
90
99
|
`--overwrite`, and `--task-ids`. Run it as
|
|
91
100
|
`uv run python -m <adapter_name>.main --output-dir <path>`.
|
|
92
101
|
|
|
93
|
-
|
|
94
|
-
`
|
|
102
|
+
For a single-step benchmark using Dockerfile-built images, generate this layout.
|
|
103
|
+
`solution/solve.sh` is optional in the format, but useful for testing the conversion.
|
|
104
|
+
Tasks using a prebuilt image can omit `environment/Dockerfile`; follow the
|
|
105
|
+
environment reference above.
|
|
95
106
|
|
|
96
107
|
```
|
|
97
108
|
<output-dir>/
|
|
@@ -149,11 +160,13 @@ OPENAI_API_KEY = "${OPENAI_API_KEY}"
|
|
|
149
160
|
**`tests/test.sh`:** must write a numeric reward (integer or float, 0 to 1) to
|
|
150
161
|
`/logs/verifier/reward.txt`, or named numbers to `/logs/verifier/reward.json`.
|
|
151
162
|
`/logs/verifier/` exists at run time. Use the same metrics as the original benchmark.
|
|
163
|
+
For multiple JSON metrics, include a `reward` key in `[0, 1]` for the primary score.
|
|
164
|
+
Install pytest in the image that runs verification; do not fetch it during the test.
|
|
152
165
|
|
|
153
166
|
```bash
|
|
154
167
|
#!/bin/bash
|
|
155
|
-
|
|
156
|
-
if
|
|
168
|
+
set -uo pipefail
|
|
169
|
+
if python3 -m pytest /tests/test_*.py; then
|
|
157
170
|
echo 1 > /logs/verifier/reward.txt
|
|
158
171
|
else
|
|
159
172
|
echo 0 > /logs/verifier/reward.txt
|
|
@@ -179,6 +192,9 @@ RUN apt-get update && apt-get install -y \
|
|
|
179
192
|
git \
|
|
180
193
|
&& rm -rf /var/lib/apt/lists/*
|
|
181
194
|
|
|
195
|
+
# The shared verifier uses the task image
|
|
196
|
+
RUN pip install --no-cache-dir 'pytest==8.4.1'
|
|
197
|
+
|
|
182
198
|
# Install benchmark-specific dependencies
|
|
183
199
|
# RUN pip install --no-cache-dir <packages>
|
|
184
200
|
|
|
@@ -211,15 +227,32 @@ run each task.
|
|
|
211
227
|
|
|
212
228
|
### 5. Verify the conversion
|
|
213
229
|
|
|
214
|
-
|
|
215
|
-
environment, its `solution/solve.sh` and its verifier, then rules on every criterion of a
|
|
216
|
-
rubric; every task should come back `no_problem_found` with `executed` true.
|
|
230
|
+
Validate the metadata, then request a hosted review of each task:
|
|
217
231
|
|
|
218
232
|
```bash
|
|
233
|
+
evolve dataset check "<output-dir>"
|
|
219
234
|
evolve check "<output-dir>" --watch
|
|
220
|
-
evolve check show <check-id>
|
|
221
235
|
```
|
|
222
236
|
|
|
237
|
+
Set `CHECK_ID` to the parent check ID returned by `evolve check`, then read it:
|
|
238
|
+
|
|
239
|
+
```bash
|
|
240
|
+
evolve check show "$CHECK_ID"
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
The first command sends `task.toml` files and any `dataset.toml` to the API for
|
|
244
|
+
validation, without uploading the full task packages or executing them. The
|
|
245
|
+
second runs a paid checker agent against a rubric. It can run the environment,
|
|
246
|
+
reference solution, and verifier when its sandbox supports them; it does not
|
|
247
|
+
guarantee that execution.
|
|
248
|
+
|
|
249
|
+
Read every task's status, findings, and evidence. The result is the
|
|
250
|
+
per-criterion JSON; Evolve derives no verdict from it. The default rubric's
|
|
251
|
+
execution criteria say whether the checker ran the task, and `unknown` on them
|
|
252
|
+
is not proof that the solution or verifier ran.
|
|
253
|
+
Use `evolve check trace <task-check-id>` to inspect the checker's work. Test any
|
|
254
|
+
unresolved execution in an environment that can run the task.
|
|
255
|
+
|
|
223
256
|
A failing check usually means one of three things, in this order:
|
|
224
257
|
|
|
225
258
|
1. **Adaptation error:** the instruction, environment or test does not match upstream.
|
|
@@ -229,14 +262,18 @@ A failing check usually means one of three things, in this order:
|
|
|
229
262
|
3. **Environment error:** a Dockerfile that does not build or a test that cannot run makes
|
|
230
263
|
the task impossible for every agent, so catch it here.
|
|
231
264
|
|
|
232
|
-
|
|
233
|
-
solution
|
|
265
|
+
The Evolve CLI has no standalone oracle command. Do not treat `evolve check` as
|
|
266
|
+
one. When a reference solution is available, verify that it earns full credit and
|
|
267
|
+
that invalid submissions fail; keep the execution evidence with the conversion.
|
|
234
268
|
|
|
235
|
-
**Benchmarks without reference solutions:**
|
|
236
|
-
|
|
237
|
-
a
|
|
269
|
+
**Benchmarks without reference solutions:** document that limitation. The default
|
|
270
|
+
checker marks the solution criterion `not_applicable` when none is shipped.
|
|
271
|
+
Write and validate solutions where possible; a model's proposed solution still
|
|
272
|
+
needs review.
|
|
238
273
|
|
|
239
|
-
**Step complete when:** every task
|
|
274
|
+
**Step complete when:** every generated task has been reviewed, confirmed defects
|
|
275
|
+
are fixed, and any unresolved execution or missing-solution limits are documented.
|
|
276
|
+
Read `evolve skills get evals core-concepts/check` for the result rules.
|
|
240
277
|
|
|
241
278
|
### 6. Document and publish
|
|
242
279
|
|
|
@@ -245,7 +282,8 @@ and every exclusion; benchmark bugs found and how they were handled; prompt
|
|
|
245
282
|
modifications, environment adjustments and other deviations from the original, with the
|
|
246
283
|
reason; known limitations; the exact commands to regenerate the tasks and to run them.
|
|
247
284
|
|
|
248
|
-
Then publish the output folder as a dataset (`evolve skills get publish`
|
|
285
|
+
Then publish the output folder as a dataset (`evolve skills get publish` explains the
|
|
286
|
+
workflow; `evolve skills get evals cli-reference/dataset` lists the options):
|
|
249
287
|
|
|
250
288
|
```bash
|
|
251
289
|
evolve dataset check "<output-dir>"
|
|
@@ -256,11 +294,18 @@ evolve run -d "<adapter-name>@1.0" -a codex -m gpt-5.5 --watch
|
|
|
256
294
|
To see how faithful the conversion is, run a job with the same agent and model the
|
|
257
295
|
benchmark's own leaderboard reports, and compare the scores.
|
|
258
296
|
|
|
297
|
+
For TypeScript or Python automation, read
|
|
298
|
+
`evolve skills get evals sdk-reference/methods/datasets`,
|
|
299
|
+
`evolve skills get evals sdk-reference/methods/checks`, and
|
|
300
|
+
`evolve skills get evals sdk-reference/methods/jobs`.
|
|
301
|
+
|
|
259
302
|
## Reference adapters by shape
|
|
260
303
|
|
|
261
304
|
Harbor's repository holds one adapter per benchmark, public at
|
|
262
305
|
https://github.com/laude-institute/harbor/tree/main/adapters. When implementation
|
|
263
|
-
questions come up, read the one that matches the benchmark's shape
|
|
306
|
+
questions come up, read the one that matches the benchmark's shape. These are
|
|
307
|
+
optional conversion examples; verify their task settings against Evolve's
|
|
308
|
+
supported scope before using them:
|
|
264
309
|
|
|
265
310
|
| Shape | Example adapter |
|
|
266
311
|
|-------|----------------|
|
|
@@ -283,5 +328,5 @@ questions come up, read the one that matches the benchmark's shape:
|
|
|
283
328
|
|---------|--------------|--------|
|
|
284
329
|
| `evolve: command not found` | The CLI is not installed | `npm install -g @evolvingmachines/evolve`. |
|
|
285
330
|
| `evolve dataset check` refuses a task by name | Its `task.toml` breaks a rule (a field, a value, a name) | Fix the converter, regenerate, check again. The refusal names the field. |
|
|
286
|
-
| A task check
|
|
331
|
+
| A task check has a `fail` outcome | One criterion failed | `evolve check show <check-id>` prints the criterion, its explanation and its evidence. |
|
|
287
332
|
| Every task fails the check the same way | An error in the task template | Fix `task-template/` in the converter, not the generated tasks. |
|