Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

refactor(managed): share metadata token schema

morluto183b4d4e7e30
diff --git a/src/domain/managed/managedArtifact.ts b/src/domain/managed/managedArtifact.ts
index 7f4810fa6..5b0d5a2ed 100644
--- a/src/domain/managed/managedArtifact.ts
+++ b/src/domain/managed/managedArtifact.ts
@@ -1,7 +1,8 @@
import { z } from "zod";
import { digestSchema } from "../digests.js";
-const tokenSchema = z.string().regex(/^0x[0-9a-f]{8}$/u);
+/** Build-local ECMA-335 metadata token emitted as an eight-digit lowercase hex value. */
+export const managedMetadataTokenSchema = z.string().regex(/^0x[0-9a-f]{8}$/u);
const offsetSchema = z.number().int().min(0);
/** A 16-byte CLI metadata GUID without RFC 4122 version/variant restrictions. */
@@ -26,7 +27,7 @@ const assemblyIdentitySchema = z.object({
flags: z.number().int().min(0).max(0xffff_ffff),
hash_algorithm: z.number().int().min(0).max(0xffff_ffff),
public_key: publicKeyIdentitySchema,
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
});
@@ -36,7 +37,7 @@ const moduleIdentitySchema = z.object({
mvid: cliMetadataGuidSchema.nullable(),
enc_id: cliMetadataGuidSchema.nullable(),
enc_base_id: cliMetadataGuidSchema.nullable(),
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
});
@@ -70,7 +71,7 @@ const assemblyReferenceSchema = z.object({
public_key_or_token: publicKeyIdentitySchema,
hash_value_sha256: digestSchema.nullable(),
hash_value_length: z.number().int().min(0),
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
});
@@ -78,23 +79,23 @@ const managedResourceSchema = z.object({
name: z.string(),
flags: z.number().int().min(0).max(0xffff_ffff),
visibility: z.enum(["public", "private", "unknown"]),
- implementation_token: tokenSchema.nullable(),
+ implementation_token: managedMetadataTokenSchema.nullable(),
embedded: z.boolean(),
declared_offset: z.number().int().min(0).max(0xffff_ffff),
data_length: z.number().int().min(0).nullable(),
data_sha256: digestSchema.nullable(),
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
});
const customAttributeSchema = z.object({
- parent_token: tokenSchema,
- constructor_token: tokenSchema.nullable(),
+ parent_token: managedMetadataTokenSchema,
+ constructor_token: managedMetadataTokenSchema.nullable(),
type_name: z.string().nullable(),
value_length: z.number().int().min(0),
value_sha256: digestSchema,
decoded_fixed_string: z.string().nullable(),
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
});
@@ -120,7 +121,7 @@ const managedSignatureSchema = z.object({
});
const managedTypeSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
namespace: z.string(),
name: z.string(),
@@ -132,8 +133,8 @@ const managedTypeSchema = z.object({
"Framed nominal namespace/name/enclosing-name digest, independent of build-local rows. Null for historical Evidence or unresolved nesting; defining assemblies and CLR runtime identity are not established.",
),
flags: z.number().int().min(0).max(0xffff_ffff),
- extends_token: tokenSchema.nullable(),
- enclosing_type_token: tokenSchema
+ extends_token: managedMetadataTokenSchema.nullable(),
+ enclosing_type_token: managedMetadataTokenSchema
.nullable()
.default(null)
.describe(
@@ -153,20 +154,20 @@ const managedTypeSchema = z.object({
/** One ExportedType row: a type this assembly exports from another module or forwards. */
const managedExportedTypeSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
namespace: z.string(),
name: z.string(),
flags: z.number().int().min(0).max(0xffff_ffff),
forwarder: z.boolean(),
type_def_id: z.number().int().min(0).max(0xffff_ffff),
- implementation_token: tokenSchema.nullable(),
+ implementation_token: managedMetadataTokenSchema.nullable(),
});
const managedFieldSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
- declaring_type_token: tokenSchema.nullable(),
+ declaring_type_token: managedMetadataTokenSchema.nullable(),
declaring_type: z.string().nullable(),
name: z.string(),
flags: z.number().int().min(0).max(0xffff),
@@ -179,7 +180,7 @@ const managedExceptionRegionSchema = z.object({
try_length: z.number().int().min(0),
handler_offset: z.number().int().min(0),
handler_length: z.number().int().min(0),
- class_token: tokenSchema.nullable(),
+ class_token: managedMetadataTokenSchema.nullable(),
filter_offset: z.number().int().min(0).nullable(),
});
@@ -210,7 +211,7 @@ const managedMethodBodySchema = z.object({
file_offset: offsetSchema.nullable(),
max_stack: z.number().int().min(0).nullable(),
init_locals: z.boolean().nullable(),
- local_var_sig_token: tokenSchema.nullable(),
+ local_var_sig_token: managedMetadataTokenSchema.nullable(),
il_size: z.number().int().min(0),
il_sha256: digestSchema
.nullable()
@@ -232,9 +233,9 @@ const managedMethodBodySchema = z.object({
});
const managedMethodSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
- declaring_type_token: tokenSchema.nullable(),
+ declaring_type_token: managedMetadataTokenSchema.nullable(),
declaring_type: z.string().nullable(),
name: z.string(),
rva: z.number().int().min(0).max(0xffff_ffff),
@@ -250,9 +251,9 @@ const managedMethodSchema = z.object({
const declaringTypeNameSchema = z.string().nullable().default(null);
const managedMemberReferenceSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
- parent_token: tokenSchema.nullable(),
+ parent_token: managedMetadataTokenSchema.nullable(),
parent_name: declaringTypeNameSchema.describe(
"Name of a TypeDef, TypeRef, or generic-instantiation TypeSpec parent; null for other parents or when unknown",
),
@@ -261,7 +262,7 @@ const managedMemberReferenceSchema = z.object({
});
const managedUserStringSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
offset: offsetSchema.describe("File offset of the #US item"),
value: z
.string()
@@ -271,21 +272,21 @@ const managedUserStringSchema = z.object({
});
const managedModuleReferenceSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
name: z.string(),
});
const managedNativeImportSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
mapping_flags: z.number().int().min(0).max(0xffff),
mapping_flags_hex: z.string().regex(/^0x[0-9a-f]{4}$/u),
- member_token: tokenSchema.nullable(),
+ member_token: managedMetadataTokenSchema.nullable(),
member_kind: z.enum(["method", "field", "unknown"]),
member_name: z.string().nullable(),
import_name: z.string(),
- import_scope_token: tokenSchema.nullable(),
+ import_scope_token: managedMetadataTokenSchema.nullable(),
import_scope_name: z.string().nullable(),
no_mangle: z.boolean(),
char_set: z.enum(["not-specified", "ansi", "unicode", "auto", "unknown"]),
@@ -310,7 +311,7 @@ const managedNativeImportSchema = z.object({
});
const managedNativeImplementationSchema = z.object({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
row_offset: offsetSchema,
name: z.string(),
rva: z.number().int().min(0).max(0xffff_ffff),
@@ -335,10 +336,10 @@ const managedNativeImplementationSchema = z.object({
});
const managedCallEdgeSchema = z.object({
- caller_token: tokenSchema,
+ caller_token: managedMetadataTokenSchema,
caller: z.string().nullable(),
opcode: z.string(),
- target_token: tokenSchema,
+ target_token: managedMetadataTokenSchema,
target_kind: z.enum(["method-def", "member-ref", "method-spec", "unknown"]),
target_name: z
.string()
@@ -350,10 +351,10 @@ const managedCallEdgeSchema = z.object({
});
const managedFieldAccessSchema = z.object({
- method_token: tokenSchema,
+ method_token: managedMetadataTokenSchema,
method: z.string().nullable(),
opcode: z.string(),
- field_token: tokenSchema,
+ field_token: managedMetadataTokenSchema,
field_name: z.string().nullable(),
field_declaring_type: declaringTypeNameSchema.describe(
"Declaring type of the accessed field; null when unknown",
diff --git a/src/domain/managed/managedMemberComparison.ts b/src/domain/managed/managedMemberComparison.ts
index 4f58590a7..be268d7c6 100644
--- a/src/domain/managed/managedMemberComparison.ts
+++ b/src/domain/managed/managedMemberComparison.ts
@@ -4,6 +4,7 @@ import { emptyArraySchema } from "../emptyArraySchema.js";
import { evidenceSchema } from "../evidence.js";
import {
cliMetadataGuidSchema,
+ managedMetadataTokenSchema,
type ManagedMemberInspection,
} from "./managedArtifact.js";
import {
@@ -23,7 +24,6 @@ import { digestSchema } from "../digests.js";
import { prefixedDigestSchema } from "../digests.js";
const evidenceIdSchema = prefixedDigestSchema("ev");
-const tokenSchema = z.string().regex(/^0x[0-9a-f]{8}$/u);
const boundedTextSchema = z.string().min(1);
/** Two authenticated managed member observations. */
@@ -47,7 +47,7 @@ const concreteMatchBasisSchema = z.enum([
"structural-method-shape",
"field-signature",
]);
-const candidateTokensSchema = z.array(tokenSchema).min(1);
+const candidateTokensSchema = z.array(managedMetadataTokenSchema).min(1);
const matchedComparisonSchema = z.strictObject({
status: z.literal("matched"),
basis: concreteMatchBasisSchema,
@@ -70,7 +70,7 @@ const ambiguousComparisonSchema = z.strictObject({
candidate_right_tokens: candidateTokensSchema,
});
const memberIdentitySchema = z.strictObject({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
declaring_type: z.string().nullable(),
name: z.string(),
signature_sha256: digestSchema,
diff --git a/src/domain/managed/managedNativeVerificationSchemas.ts b/src/domain/managed/managedNativeVerificationSchemas.ts
index 320842a75..d85016a58 100644
--- a/src/domain/managed/managedNativeVerificationSchemas.ts
+++ b/src/domain/managed/managedNativeVerificationSchemas.ts
@@ -2,12 +2,14 @@ import { z } from "zod";
import { emptyArraySchema } from "../emptyArraySchema.js";
import { evidenceSchema } from "../evidence.js";
-import { cliMetadataGuidSchema } from "./managedArtifact.js";
+import {
+ cliMetadataGuidSchema,
+ managedMetadataTokenSchema,
+} from "./managedArtifact.js";
import { digestSchema } from "../digests.js";
import { prefixedDigestSchema } from "../digests.js";
const evidenceIdSchema = prefixedDigestSchema("ev");
-const tokenSchema = z.string().regex(/^0x[0-9a-f]{8}$/u);
const textSchema = z.string().min(1);
const nativeSymbolSchema = z.strictObject({
@@ -25,8 +27,8 @@ export type NativeSymbol = z.infer<typeof nativeSymbolSchema>;
const pinvokeVerificationContextShape = {
item_id: prefixedDigestSchema("mnv_pinvoke"),
managed: z.strictObject({
- token: tokenSchema,
- member_token: tokenSchema.nullable(),
+ token: managedMetadataTokenSchema,
+ member_token: managedMetadataTokenSchema.nullable(),
member_name: z.string().nullable(),
import_name: z.string().min(1),
import_scope_name: z.string().nullable(),
diff --git a/src/domain/managed/managedReconstruction.ts b/src/domain/managed/managedReconstruction.ts
index 9600166ae..d0fa71aaa 100644
--- a/src/domain/managed/managedReconstruction.ts
+++ b/src/domain/managed/managedReconstruction.ts
@@ -6,6 +6,7 @@ import { z } from "zod";
import { evidenceSchema, type Evidence } from "../evidence.js";
import {
cliMetadataGuidSchema,
+ managedMetadataTokenSchema,
managedMemberInspectionSchema,
type ManagedMemberInspection,
} from "./managedArtifact.js";
@@ -14,7 +15,6 @@ import { digestSchema, prefixedDigestSchema } from "../digests.js";
import { parseManagedInspectionEvidence } from "./managedInspectionEvidence.js";
const evidenceIdSchema = prefixedDigestSchema("ev");
-const tokenSchema = z.string().regex(/^0x[0-9a-f]{8}$/u);
const textSchema = z.string().min(1);
const decompilerSchema = z.strictObject({
@@ -26,7 +26,7 @@ const decompilerSchema = z.strictObject({
});
const managedReconstructionMethodInputSchema = z.strictObject({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
signature_sha256: digestSchema,
normalized_il_sha256: digestSchema.nullable(),
reconstruction: z.strictObject({
@@ -52,7 +52,7 @@ export const managedReconstructionImportInputSchema = z.strictObject({
});
const importedMethodSchema = z.strictObject({
- token: tokenSchema,
+ token: managedMetadataTokenSchema,
declaring_type: z.string().nullable(),
name: z.string(),
signature_sha256: digestSchema,