@tangle-network/agent-interface 0.27.1 → 0.28.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent-candidate-artifact-schema.d.ts +0 -3
- package/dist/agent-candidate-artifact-schema.js +0 -2
- package/dist/agent-candidate-code-schema.d.ts +0 -2
- package/dist/agent-candidate-execution-plan-schema.d.ts +0 -32
- package/dist/agent-candidate-execution-plan-schema.js +3 -7
- package/dist/agent-candidate-lineage-schema.d.ts +0 -3
- package/dist/agent-candidate-lineage-schema.js +0 -1
- package/dist/agent-candidate-outcome-schema.d.ts +0 -18
- package/dist/agent-candidate-outcome-schema.js +4 -8
- package/dist/agent-candidate-promotion-schema.d.ts +0 -53
- package/dist/agent-candidate-promotion-schema.js +0 -4
- package/dist/agent-candidate-receipt-schema.d.ts +0 -41
- package/dist/agent-candidate-receipt-schema.js +0 -3
- package/dist/agent-candidate-schema.d.ts +0 -6
- package/dist/agent-candidate-schema.js +0 -1
- package/dist/agent-candidate.d.ts +0 -22
- package/dist/agent-candidate.test-fixture.d.ts +0 -6
- package/dist/agent-candidate.test-fixture.js +0 -6
- package/dist/index.d.ts +0 -1
- package/dist/index.js +0 -1
- package/dist/profile-diff.d.ts +0 -1
- package/dist/profile-schema.js +4 -3
- package/package.json +2 -1
- package/dist/agent-candidate-compat.d.ts +0 -1918
- package/dist/agent-candidate-compat.js +0 -340
|
@@ -8,7 +8,6 @@ import { z } from "zod";
|
|
|
8
8
|
* compares lowercase `sha256:<hex>` identities before materialization.
|
|
9
9
|
*/
|
|
10
10
|
export declare const agentCandidateBundleSchema: z.ZodObject<{
|
|
11
|
-
schemaVersion: z.ZodLiteral<2>;
|
|
12
11
|
kind: z.ZodLiteral<"agent-candidate-bundle">;
|
|
13
12
|
digestAlgorithm: z.ZodLiteral<"rfc8785-sha256">;
|
|
14
13
|
profile: z.ZodObject<{
|
|
@@ -359,11 +358,9 @@ export declare const agentCandidateBundleSchema: z.ZodObject<{
|
|
|
359
358
|
kind: z.ZodLiteral<"evaluator-task-container">;
|
|
360
359
|
}, z.core.$strict>], "kind">;
|
|
361
360
|
workspace: z.ZodOptional<z.ZodObject<{
|
|
362
|
-
schemaVersion: z.ZodLiteral<2>;
|
|
363
361
|
kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
|
|
364
362
|
digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
|
|
365
363
|
material: z.ZodObject<{
|
|
366
|
-
schemaVersion: z.ZodLiteral<2>;
|
|
367
364
|
kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
|
|
368
365
|
files: z.ZodArray<z.ZodObject<{
|
|
369
366
|
path: z.ZodString;
|
|
@@ -419,7 +416,6 @@ export declare const agentCandidateBundleSchema: z.ZodObject<{
|
|
|
419
416
|
}, z.core.$strict>;
|
|
420
417
|
knowledge: z.ZodOptional<z.ZodObject<{
|
|
421
418
|
candidate: z.ZodObject<{
|
|
422
|
-
schemaVersion: z.ZodLiteral<1>;
|
|
423
419
|
kind: z.ZodLiteral<"knowledge-improvement-candidate">;
|
|
424
420
|
runId: z.ZodString;
|
|
425
421
|
candidateId: z.ZodString;
|
|
@@ -430,11 +426,9 @@ export declare const agentCandidateBundleSchema: z.ZodObject<{
|
|
|
430
426
|
promotionPlanHash: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
|
|
431
427
|
}, z.core.$strict>;
|
|
432
428
|
snapshot: z.ZodObject<{
|
|
433
|
-
schemaVersion: z.ZodLiteral<2>;
|
|
434
429
|
kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
|
|
435
430
|
digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
|
|
436
431
|
material: z.ZodObject<{
|
|
437
|
-
schemaVersion: z.ZodLiteral<2>;
|
|
438
432
|
kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
|
|
439
433
|
files: z.ZodArray<z.ZodObject<{
|
|
440
434
|
path: z.ZodString;
|
|
@@ -14,7 +14,6 @@ import { canonicalizeHarness } from "./harness.js";
|
|
|
14
14
|
*/
|
|
15
15
|
export const agentCandidateBundleSchema = z
|
|
16
16
|
.object({
|
|
17
|
-
schemaVersion: z.literal(2),
|
|
18
17
|
kind: z.literal("agent-candidate-bundle"),
|
|
19
18
|
digestAlgorithm: z.literal("rfc8785-sha256"),
|
|
20
19
|
profile: agentCandidateProfileSchema,
|
|
@@ -201,7 +201,6 @@ export interface AgentCandidateExecution {
|
|
|
201
201
|
}
|
|
202
202
|
/** Exact frozen knowledge candidate admitted only through an approved review. */
|
|
203
203
|
export interface AgentCandidateKnowledgeRef {
|
|
204
|
-
schemaVersion: 1;
|
|
205
204
|
kind: "knowledge-improvement-candidate";
|
|
206
205
|
runId: string;
|
|
207
206
|
candidateId: string;
|
|
@@ -269,7 +268,6 @@ export interface AgentCandidateLineage {
|
|
|
269
268
|
* artifact hashes are untrusted until recomputed.
|
|
270
269
|
*/
|
|
271
270
|
export interface AgentCandidateBundle {
|
|
272
|
-
schemaVersion: 2;
|
|
273
271
|
kind: "agent-candidate-bundle";
|
|
274
272
|
digestAlgorithm: AgentCandidateDigestAlgorithm;
|
|
275
273
|
profile: AgentCandidateProfile;
|
|
@@ -299,7 +297,6 @@ export interface AgentCandidateResolvedModel {
|
|
|
299
297
|
}
|
|
300
298
|
/** Canonical, digest-free profile-plan identity document. */
|
|
301
299
|
export interface AgentCandidateProfilePlanMaterial {
|
|
302
|
-
version: 1;
|
|
303
300
|
harness: HarnessType;
|
|
304
301
|
files: Array<{
|
|
305
302
|
relPath: string;
|
|
@@ -314,7 +311,6 @@ export interface AgentCandidateProfilePlanMaterial {
|
|
|
314
311
|
}>;
|
|
315
312
|
}
|
|
316
313
|
export interface AgentCandidateWorkspaceManifestMaterial {
|
|
317
|
-
schemaVersion: 2;
|
|
318
314
|
kind: "agent-candidate-workspace-manifest";
|
|
319
315
|
files: Array<{
|
|
320
316
|
path: string;
|
|
@@ -326,7 +322,6 @@ export interface AgentCandidateWorkspaceManifestMaterial {
|
|
|
326
322
|
}
|
|
327
323
|
/** Content-addressed manifest of every file uploaded to one workspace. */
|
|
328
324
|
export interface AgentCandidateWorkspaceSnapshotEvidence {
|
|
329
|
-
schemaVersion: 2;
|
|
330
325
|
kind: "agent-candidate-workspace-snapshot";
|
|
331
326
|
digest: Sha256Digest;
|
|
332
327
|
material: AgentCandidateWorkspaceManifestMaterial;
|
|
@@ -402,7 +397,6 @@ export type AgentCandidateTaskOutcomeSpec = {
|
|
|
402
397
|
* its raw SHA-256 is the execution-plan digest.
|
|
403
398
|
*/
|
|
404
399
|
export interface AgentCandidateExecutionPlanMaterial {
|
|
405
|
-
schemaVersion: 2;
|
|
406
400
|
kind: "agent-candidate-execution-plan-material";
|
|
407
401
|
bundleDigest: Sha256Digest;
|
|
408
402
|
executionId: string;
|
|
@@ -482,7 +476,6 @@ export interface AgentCandidateExecutionPlanMaterial {
|
|
|
482
476
|
};
|
|
483
477
|
}
|
|
484
478
|
export interface AgentCandidateProfilePlanEvidence {
|
|
485
|
-
schemaVersion: 1;
|
|
486
479
|
kind: "agent-profile-workspace-plan";
|
|
487
480
|
digest: Sha256Digest;
|
|
488
481
|
material: AgentCandidateProfilePlanMaterial;
|
|
@@ -490,7 +483,6 @@ export interface AgentCandidateProfilePlanEvidence {
|
|
|
490
483
|
}
|
|
491
484
|
/** Exact native profile files and the canonical plan that activated them. */
|
|
492
485
|
export interface AgentCandidateProfileActivation {
|
|
493
|
-
schemaVersion: 1;
|
|
494
486
|
kind: "agent-candidate-profile-activation";
|
|
495
487
|
profilePlan: AgentCandidateProfilePlanEvidence;
|
|
496
488
|
files: Array<{
|
|
@@ -501,14 +493,12 @@ export interface AgentCandidateProfileActivation {
|
|
|
501
493
|
digest: Sha256Digest;
|
|
502
494
|
}
|
|
503
495
|
export interface AgentCandidateExecutionPlanEvidence {
|
|
504
|
-
schemaVersion: 2;
|
|
505
496
|
kind: "agent-candidate-execution-plan";
|
|
506
497
|
digest: Sha256Digest;
|
|
507
498
|
material: AgentCandidateExecutionPlanMaterial;
|
|
508
499
|
artifact: AgentCandidateCapturedArtifact;
|
|
509
500
|
}
|
|
510
501
|
export interface AgentCandidateTraceEvidence {
|
|
511
|
-
schemaVersion: 1;
|
|
512
502
|
artifact: AgentCandidateCapturedArtifact;
|
|
513
503
|
eventCount: number;
|
|
514
504
|
modelCallCount: number;
|
|
@@ -525,7 +515,6 @@ export type AgentCandidateMemoryReceipt = {
|
|
|
525
515
|
};
|
|
526
516
|
/** Proof emitted after a runtime materializes, but before it executes, a bundle. */
|
|
527
517
|
export interface AgentCandidateMaterializationReceipt {
|
|
528
|
-
schemaVersion: 2;
|
|
529
518
|
kind: "agent-candidate-materialization";
|
|
530
519
|
digestAlgorithm: AgentCandidateDigestAlgorithm;
|
|
531
520
|
bundleDigest: Sha256Digest;
|
|
@@ -563,7 +552,6 @@ export type AgentCandidateTermination = {
|
|
|
563
552
|
};
|
|
564
553
|
/** Proof emitted after the exact materialized plan finishes executing. */
|
|
565
554
|
export interface AgentCandidateRunReceipt {
|
|
566
|
-
schemaVersion: 3;
|
|
567
555
|
kind: "agent-candidate-run";
|
|
568
556
|
digestAlgorithm: AgentCandidateDigestAlgorithm;
|
|
569
557
|
bundleDigest: Sha256Digest;
|
|
@@ -581,7 +569,6 @@ export interface AgentCandidateRunReceipt {
|
|
|
581
569
|
export type AgentImprovementSurface = "prompt" | "skills" | "tools" | "mcp" | "hooks" | "subagents" | "agent-profile" | "memory" | "code" | "knowledge";
|
|
582
570
|
/** Portable paired held-out comparison produced by an evaluation package. */
|
|
583
571
|
export interface AgentImprovementMeasuredComparison {
|
|
584
|
-
schemaVersion: 1;
|
|
585
572
|
kind: "agent-improvement-measured-comparison";
|
|
586
573
|
benchmark: {
|
|
587
574
|
name: string;
|
|
@@ -686,7 +673,6 @@ export interface AgentImprovementMeasuredComparison {
|
|
|
686
673
|
};
|
|
687
674
|
}
|
|
688
675
|
export interface AgentImprovementProposal {
|
|
689
|
-
schemaVersion: 1;
|
|
690
676
|
kind: "agent-improvement-proposal";
|
|
691
677
|
runId: string;
|
|
692
678
|
changedSurfaces: [AgentImprovementSurface, ...AgentImprovementSurface[]];
|
|
@@ -702,7 +688,6 @@ export interface AgentImprovementProposal {
|
|
|
702
688
|
export type AgentImprovementReviewDecision = "approve" | "reject" | "request-changes";
|
|
703
689
|
/** Human or tenant-policy decision bound to one exact proposal. */
|
|
704
690
|
export interface AgentImprovementReview {
|
|
705
|
-
schemaVersion: 1;
|
|
706
691
|
kind: "agent-improvement-review";
|
|
707
692
|
proposalDigest: Sha256Digest;
|
|
708
693
|
candidateBundleDigest: Sha256Digest;
|
|
@@ -715,7 +700,6 @@ export interface AgentImprovementReview {
|
|
|
715
700
|
}
|
|
716
701
|
/** Successful post-approval execution, carrying the exact Runtime receipt. */
|
|
717
702
|
export interface CandidateExecutionEvidence {
|
|
718
|
-
schemaVersion: 1;
|
|
719
703
|
kind: "agent-candidate-execution-evidence";
|
|
720
704
|
proposalDigest: Sha256Digest;
|
|
721
705
|
reviewDigest: Sha256Digest;
|
|
@@ -743,7 +727,6 @@ export interface AgentCandidateModelSettlementCall {
|
|
|
743
727
|
}
|
|
744
728
|
/** Canonical model-access ledger after the evaluator has revoked access. */
|
|
745
729
|
export interface AgentCandidateModelSettlementMaterial {
|
|
746
|
-
schemaVersion: 2;
|
|
747
730
|
kind: "agent-candidate-model-settlement-material";
|
|
748
731
|
executionPlanDigest: Sha256Digest;
|
|
749
732
|
preparationId: string;
|
|
@@ -754,7 +737,6 @@ export interface AgentCandidateModelSettlementMaterial {
|
|
|
754
737
|
usage: AgentCandidateFixedSpend;
|
|
755
738
|
}
|
|
756
739
|
export interface AgentCandidateModelSettlementEvidence {
|
|
757
|
-
schemaVersion: 2;
|
|
758
740
|
kind: "agent-candidate-model-settlement";
|
|
759
741
|
digest: Sha256Digest;
|
|
760
742
|
material: AgentCandidateModelSettlementMaterial;
|
|
@@ -769,7 +751,6 @@ export interface AgentCandidateRepositoryState {
|
|
|
769
751
|
}
|
|
770
752
|
/** Canonical result captured by the evaluator after one candidate task. */
|
|
771
753
|
export interface AgentCandidateTaskOutcomeMaterial {
|
|
772
|
-
schemaVersion: 2;
|
|
773
754
|
kind: "agent-candidate-task-outcome-material";
|
|
774
755
|
executionPlanDigest: Sha256Digest;
|
|
775
756
|
outcome: {
|
|
@@ -788,7 +769,6 @@ export interface AgentCandidateTaskOutcomeMaterial {
|
|
|
788
769
|
};
|
|
789
770
|
}
|
|
790
771
|
export interface AgentCandidateTaskOutcomeEvidence {
|
|
791
|
-
schemaVersion: 2;
|
|
792
772
|
kind: "agent-candidate-task-outcome";
|
|
793
773
|
digest: Sha256Digest;
|
|
794
774
|
material: AgentCandidateTaskOutcomeMaterial;
|
|
@@ -800,7 +780,6 @@ export interface AgentCandidateBenchmarkDimension {
|
|
|
800
780
|
}
|
|
801
781
|
/** Canonical executable-grade result for one task outcome. */
|
|
802
782
|
export interface AgentCandidateBenchmarkResultMaterial {
|
|
803
|
-
schemaVersion: 1;
|
|
804
783
|
kind: "agent-candidate-benchmark-result-material";
|
|
805
784
|
executionPlanDigest: Sha256Digest;
|
|
806
785
|
taskOutcomeDigest: Sha256Digest;
|
|
@@ -822,7 +801,6 @@ export interface AgentCandidateBenchmarkResultMaterial {
|
|
|
822
801
|
dimensions: AgentCandidateBenchmarkDimension[];
|
|
823
802
|
}
|
|
824
803
|
export interface AgentCandidateBenchmarkResultEvidence {
|
|
825
|
-
schemaVersion: 1;
|
|
826
804
|
kind: "agent-candidate-benchmark-result";
|
|
827
805
|
digest: Sha256Digest;
|
|
828
806
|
material: AgentCandidateBenchmarkResultMaterial;
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
export declare const candidateSha: (digit: string) => `sha256:${string}`;
|
|
2
2
|
export declare const candidateGit: (digit: string) => string;
|
|
3
3
|
export declare function candidateFixture(): {
|
|
4
|
-
schemaVersion: 2;
|
|
5
4
|
kind: "agent-candidate-bundle";
|
|
6
5
|
digestAlgorithm: "rfc8785-sha256";
|
|
7
6
|
profile: {
|
|
@@ -81,11 +80,9 @@ export declare function candidateFixture(): {
|
|
|
81
80
|
};
|
|
82
81
|
};
|
|
83
82
|
workspace: {
|
|
84
|
-
schemaVersion: 2;
|
|
85
83
|
kind: "agent-candidate-workspace-snapshot";
|
|
86
84
|
digest: `sha256:${string}`;
|
|
87
85
|
material: {
|
|
88
|
-
schemaVersion: 2;
|
|
89
86
|
kind: "agent-candidate-workspace-manifest";
|
|
90
87
|
files: {
|
|
91
88
|
path: string;
|
|
@@ -115,7 +112,6 @@ export declare function candidateFixture(): {
|
|
|
115
112
|
};
|
|
116
113
|
knowledge: {
|
|
117
114
|
candidate: {
|
|
118
|
-
schemaVersion: 1;
|
|
119
115
|
kind: "knowledge-improvement-candidate";
|
|
120
116
|
runId: string;
|
|
121
117
|
candidateId: string;
|
|
@@ -126,11 +122,9 @@ export declare function candidateFixture(): {
|
|
|
126
122
|
promotionPlanHash: `sha256:${string}`;
|
|
127
123
|
};
|
|
128
124
|
snapshot: {
|
|
129
|
-
schemaVersion: 2;
|
|
130
125
|
kind: "agent-candidate-workspace-snapshot";
|
|
131
126
|
digest: `sha256:${string}`;
|
|
132
127
|
material: {
|
|
133
|
-
schemaVersion: 2;
|
|
134
128
|
kind: "agent-candidate-workspace-manifest";
|
|
135
129
|
files: never[];
|
|
136
130
|
};
|
|
@@ -3,7 +3,6 @@ export const candidateSha = (digit) => `sha256:${digit.repeat(64)}`;
|
|
|
3
3
|
export const candidateGit = (digit) => digit.repeat(40);
|
|
4
4
|
export function candidateFixture() {
|
|
5
5
|
return defineAgentCandidateBundle({
|
|
6
|
-
schemaVersion: 2,
|
|
7
6
|
kind: "agent-candidate-bundle",
|
|
8
7
|
digestAlgorithm: "rfc8785-sha256",
|
|
9
8
|
profile: {
|
|
@@ -69,11 +68,9 @@ export function candidateFixture() {
|
|
|
69
68
|
container: { image: "node:22", indexDigest: candidateSha("6") },
|
|
70
69
|
},
|
|
71
70
|
workspace: {
|
|
72
|
-
schemaVersion: 2,
|
|
73
71
|
kind: "agent-candidate-workspace-snapshot",
|
|
74
72
|
digest: candidateSha("c"),
|
|
75
73
|
material: {
|
|
76
|
-
schemaVersion: 2,
|
|
77
74
|
kind: "agent-candidate-workspace-manifest",
|
|
78
75
|
files: [
|
|
79
76
|
{
|
|
@@ -105,7 +102,6 @@ export function candidateFixture() {
|
|
|
105
102
|
},
|
|
106
103
|
knowledge: {
|
|
107
104
|
candidate: {
|
|
108
|
-
schemaVersion: 1,
|
|
109
105
|
kind: "knowledge-improvement-candidate",
|
|
110
106
|
runId: "knowledge-run-17",
|
|
111
107
|
candidateId: "knowledge-17",
|
|
@@ -116,11 +112,9 @@ export function candidateFixture() {
|
|
|
116
112
|
promotionPlanHash: candidateSha("9"),
|
|
117
113
|
},
|
|
118
114
|
snapshot: {
|
|
119
|
-
schemaVersion: 2,
|
|
120
115
|
kind: "agent-candidate-workspace-snapshot",
|
|
121
116
|
digest: candidateSha("7"),
|
|
122
117
|
material: {
|
|
123
|
-
schemaVersion: 2,
|
|
124
118
|
kind: "agent-candidate-workspace-manifest",
|
|
125
119
|
files: [],
|
|
126
120
|
},
|
package/dist/index.d.ts
CHANGED
|
@@ -614,7 +614,6 @@ export * from "./interaction.js";
|
|
|
614
614
|
export * from "./agent-candidate.js";
|
|
615
615
|
export * from "./agent-candidate-schema.js";
|
|
616
616
|
export * from "./agent-candidate-promotion-schema.js";
|
|
617
|
-
export * from "./agent-candidate-compat.js";
|
|
618
617
|
export * from "./agent-profile.js";
|
|
619
618
|
export * from "./profile-diff.js";
|
|
620
619
|
export * from "./harness.js";
|
package/dist/index.js
CHANGED
|
@@ -127,7 +127,6 @@ export * from "./interaction.js";
|
|
|
127
127
|
export * from "./agent-candidate.js";
|
|
128
128
|
export * from "./agent-candidate-schema.js";
|
|
129
129
|
export * from "./agent-candidate-promotion-schema.js";
|
|
130
|
-
export * from "./agent-candidate-compat.js";
|
|
131
130
|
export * from "./agent-profile.js";
|
|
132
131
|
export * from "./profile-diff.js";
|
|
133
132
|
export * from "./harness.js";
|
package/dist/profile-diff.d.ts
CHANGED
package/dist/profile-schema.js
CHANGED
|
@@ -159,8 +159,8 @@ export const agentProfileSchema = z.object({
|
|
|
159
159
|
.record(z.string(), z.union([z.record(z.string(), z.unknown()), z.undefined()]))
|
|
160
160
|
.optional(),
|
|
161
161
|
});
|
|
162
|
-
export const agentProfileDiffSchema = z
|
|
163
|
-
|
|
162
|
+
export const agentProfileDiffSchema = z
|
|
163
|
+
.object({
|
|
164
164
|
kind: z.literal("agent-profile-diff"),
|
|
165
165
|
id: z.string().min(1).optional(),
|
|
166
166
|
title: z.string().min(1).optional(),
|
|
@@ -182,7 +182,8 @@ export const agentProfileDiffSchema = z.object({
|
|
|
182
182
|
set: agentProfileSchema.optional(),
|
|
183
183
|
remove: agentProfileDiffRemovalSchema.optional(),
|
|
184
184
|
metadata: z.record(z.string(), z.unknown()).optional(),
|
|
185
|
-
})
|
|
185
|
+
})
|
|
186
|
+
.strict();
|
|
186
187
|
const _agentProfileSchemaMatchesInterface = true;
|
|
187
188
|
void _agentProfileSchemaMatchesInterface;
|
|
188
189
|
export const capabilitySchema = z.object({
|