Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
refactor(managed): share metadata token schema
morluto183b4d4e7e30
diff --git a/src/domain/managed/managedArtifact.ts b/src/domain/managed/managedArtifact.tsindex 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.tsindex 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.tsindex 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.tsindex 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,